Device2Device Nedir?
Device2Device (D2D), Ödeal POS cihazına iş ortağı cihazının tanımlandığı bir entegrasyon profilidir. Sepet iş ortağı cihazında oluşturulur, Ödeal cihazına gönderilir ve ödeme Ödeal uygulaması tarafında tamamlanır.
🔄 Nasıl Çalışır?
1. Sepet Oluşturulması ve Gönderilmesi
İş ortağı cihazı, ödeme için gerekli bilgileri içeren bir sepet oluşturur.
ÖN KOŞUL
Öncesinde Ödeal POS cihazı içerisinde bulunan Ödeal Stage uygulamasında Cihazlarım menüsünden cihaza bir cihaz kodu tanımlaması yapılmalıdır.
Sepet Gönderimi:
- Sepet, API üzerinden Ödeal server'a gönderilir
- Sepet içinde POS cihazına ait bir eşleştirme anahtarı yer alır
- Bu anahtar, Cihazlarım menüsünden cihaza verilen cihaz kodudur
- Sepet requestinde
externalDeviceKeyalanında gönderilir - Böylelikle sepet ve cihaz eşleşmesi sağlanmış olur
2. Sepet Karşılanması ve POS Cihazı ile İletişim
- Ödeal server, gönderilen sepeti alır ve işler
- Bu işlemin ardından, Ödeal POS cihazı otomatik uyanır
- Sepet kullanıcıya görünür hale gelir
3. Ödeme ve Fatura Oluşumu
- Ödeme, Ödeal uygulaması tarafından tamamlanır
- Ödeme tamamlandığında, alıcıya uygun şekilde E-Fatura veya E-Arşiv Faturası otomatik olarak Ödeal tarafından oluşturulur
🔔 Callback URL Tanımlanması
Callback URL Nedir?
İş ortağı, ödeme ve fatura işlemleriyle ilgili olarak belirli callback URL'ler tanımlar. Bu URL'ler, iş ortağının sistemine bilgi iletmek için kullanılır.
CALLBACK KAYDI
Tanımlanan URL'ler Ödeal'a konfigürasyon metodu ile iletilir ve Ödeal, bu URL'leri kendi sistemine kaydeder.
Callback URL Türleri
💚 Payment Succeeded URL
Bu URL'ye ödeme başarıyla tamamlandığında bilgi gönderilir. Ödeal, ödeme işleminden başarılı sonuç alındığında bu URL'yi kullanarak iş ortağının uygulamasına gerekli bildirimleri iletir.
⚠️ Payment Cancelled URL
Eğer ödeme işlemi başarılı bir şekilde tamamlandıysa ve sonrasında ödeme cihazdan iptal edilirse, bu URL üzerinden iptal bilgisi gönderilir. Yani, ödeme iptal edildiğinde iş ortağı bu bilgiyi alır.
❌ Payment Failed URL
Ödeme işlemi bir hata nedeniyle başarısız olduğunda, bu URL üzerinden hata bilgisi iletilir. İş ortağı, bu URL aracılığıyla başarısız ödeme ile ilgili bilgilere ulaşır.
📄 E-Invoice Created URL
Eğer ödeme başarılı şekilde tamamlanırsa, otomatik olarak Ödeal tarafından e-faturası oluşturulur, bu URL üzerinden fatura bilgileri iş ortağına iletilir.
🗑️ E-Invoice Cancelled URL
Eğer bir fatura iptal edilirse, bu URL aracılığıyla iş ortağına fatura iptal bilgisi gönderilir.
📝 Özet
CALLBACK URL'LERİN ROLÜ
Callback URL'ler, ödeme ve fatura işlemleriyle ilgili her türlü durumu iş ortağının sistemine iletmek için kullanılır:
- ✅ Başarılı ödemeler
- ❌ Başarısız ödemeler
- ⚠️ İptal işlemleri
- 📄 Fatura oluşturma
- 🗑️ Fatura iptali
İş ortağı, bu URL'leri belirleyip Ödeal'a ileterek ödeme süreçlerini takip edebilir ve gerekli aksiyonları alabilir.