App2App Nedir?
App2App, bir ödeme işleminin iş ortağı uygulamasından başlatılarak Ödeal uygulamasında tamamlandığı bir entegrasyon profilidir.
İş ortağı mobil uygulamasından Ödeal uygulaması uyandırılır, ödeme tamamlandıktan sonra ödeme sonucu tekrar iş ortağı uygulamasına gönderilir.
Nasıl Çalışır?
İş ortağı uygulamasında hazırlanan sepet, Ödeal mobil uygulamasını sadece sepete ait tekil referans kodu ile açmak yeterlidir. İş ortağı uygulamasından Android ya da Kotlin kod örnekleriyle sağlanabilir.
Ödeal'a iletilen tekil sepet referans kodu ile Ödeal, servis üzerinden sepet detaylarını almak için iş ortağının açtığı servise istekte bulunur. Alınan sepet detaylarına istinaden cihazdan ödeme işlemi gerçekleştirilir ve sonucu Ödeal tarafından geri bildirim servisleriyle iletilir.
Başlamadan Önce Önemli Adımlar
Konfigürasyon Tanımı
Konfigürasyon servisi, iş ortağı ile yapılan entegrasyonlarda iş ortağı tarafından açılması beklenen servislerle ilgili URL bilgilerinin Ödeal'a iletildiği servistir. Entegrasyon ile ilgili gerekli bilgilerin yönetimi için gerekli bilgilerin iletildiği istektir.
ÖNEMLİ NOT
Konfigürasyon tanımı tek seferliğe mahsus yapılmaktadır. Konfigürasyon tanımının önemi, işlemlerin sağlanması için parametrelerin tanımlı olması gerekmesidir.
basketUrl: basketUrl bilgisi, sepet bilgisinin alınacağı URL bilgisidir. Bu tanım konfigürasyon servisi ile yapılabilir. APP2APP profilde sepet detaylarının iş ortağından çekilebilmesi için muhakkak bu tanımın yapılması gereklidir.
IntentUrl: IntentUrl bilgisi, ödeme başarılı, ödeme başarısız bilgisinin iş ortağı uygulamasına bildirildiği URL bilgisidir. Bu tanım konfigürasyon servisi ile yapılabilir. APP2APP profilde ödeme başarılı, başarısız bilgisinin iş ortağı uygulamasına bildirilmesi için muhakkak bu tanımın yapılması gereklidir.
İşlem Adımları
Ödeme Akışı
Sepet Oluşturma
İşlem iş ortağı uygulamasından başlatılır, yani sepet oluşturulur.Ödeal Uygulamasının Uyandırılması
İş ortağı uygulamasından ödeme adımı için sepet ID (basketRefCode) bilgisiyle tahsilat işlemi Ödeal uygulamasına gönderilir.Sepet Referansının İletilmesi
Uyandırılan Ödeal uygulaması, Ödeal backend'ine sepet referans kodunu iletir.Sepet Detaylarının Alınması
Ödeal, iş ortağının açtığı sepet servisi aracılığıyla sepet referans kodu bilgisiyle iş ortağı backend'inden sepet detaylarını almak için istek gönderir.
Ürün Bilgilerinin Aktarılması
Sepetten alınan bilgilere istinaden ürün detay ve tutarlar Ödeal'a aktarılır.Fatura Bilgilerinin Belirlenmesi
Sepetten gelen bilgilere istinaden fatura bilgilerinin ne olacağı da bu aşamada Ödeal'a iletiliyor olur.Bu aşamada iş ortağından alınan bilgilere bakılmaksızın Ödeal, edindiği kimlik bilgilerini TODEB üzerinden sorgular ve gelen bilgilere göre fatura bilgilerini hazırlar. :::
Ödeme İşleminin Bankaya İletilmesi
Alınan sepet detaylarına istinaden ödeme işlemi TechPos aracılığıyla bankaya iletilir.Ödeme Sonucunun İletilmesi
Bankadan alınan cevaba istinaden Ödeal, ödeme işleminin cevabını iş ortağının açmış olduğu Intent URL aracılığıyla işlem sonucunu ilgili iş ortağı uygulamasına gönderir.E-Belge Oluşturma
İşlem başarılıysa işleme ait e-belgenin hazırlanması için Ödeal e-fatura oluşturma işlemini başlatır. (Hazırlanması belli bir süre sonra olabilir)Fatura Bilgisinin İletilmesi
Oluşturulan belgeyi Ödeal, iş ortağının açmış olduğu fatura (callback) servisi aracılığıyla ilgili iş ortağı servis URL'ine gönderir. Fatura bilgisisi için iş ortağı bir callback adresi tanımı yapması gerekmektedir. Yine konfigürasyon metodu ile bu url tanımı yapılabilmektedir.
İptal İşlemi Akışı
ÖNEMLI KOŞULLAR
- Gün Sonu Kontrolü: İşlem henüz gün sonu alınmamış olmalıdır
- E-Fatura Durumu: E-fatura oluşturulmuşsa işlem iptal edilemez
- Görsel Gösterim: İptal edilen işlemler menüde kırmızı renk ile gösterilir