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.

ÜRÜN BİRİMLERİ DİKKAT

Sepette ürün bilgilerini iletirken ürün birimleri Ödeal'a uygun olmalıdır. Ürün birim kodları için Ödeal ile iletişime geçiniz.

📋 Başlamadan Önce Önemli Adımlar

1. 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.

Örnek: basketUrl bilgisi, sepet bilgisinin alınacağı URL bilgisidir. Eğer Geri Bildirim'in altındaki servisler kullanılacaksa burada tanımlamak gerekmektedir.

👥 Üyelik Süreci

App2App profilde Ödeal ile üyelik süreci aşağıdaki adımlardan oluşur:

1. Lead/Satış Kaydı
   İş ortağı Ödeal'a (iş modeline bağlı olarak) satış veya lead kaydı gönderir.

2. Operasyon Süreci
   Ödeal operasyon ekibinin belirli işlemleri sonrasında satış süreci ilerletilir ve üye ile iletişime geçilir. (İş modeline göre farklılıklar olabilir)

3. Kurulum Başlatma
   Kurulum süreci başlatılır ve buna istinaden iş emirleri gönderilir. Bu aşamada hem iş ortağı uygulaması hem de Ödeal uygulaması için kurulum talepi yapılır.

4. Cihaz Gönderimi
   Cihaz gönderimi gerçekleşir.

5. API Anahtarlarının Tanımlanması
   Üye işyeri Ödeal Portal üzerinden Secret ve Public Key'leri alarak iş ortağında karşılık gelen ilgili alanlara bu parametreleri ekler. Böylece işyerine özel olarak verilmiş özel anahtarlar tanımlanmış olur ve servis isteklerinde bunlar kullanılır.

6. Teknik Kurulum
   Üyeye ulaşmış cihaza tekniker gönderilerek kurulumlar yapılır ve cihaz işleme hazır hale gelir.

🔄 İşlem Adımları

Ödeme Akışı

1. Sepet Oluşturma
   İşlem iş ortağı uygulamasından başlatılır, yani sepet oluşturulur.

2. Ödeal Uygulamasının Uyandırılması
   İş ortağı uygulamasından ödeme adımı için sepet ID bilgisiyle tahsilat işlemi Ödeal uygulamasına gönderilir.

3. Sepet Referansının İletilmesi
   Uyandırılan Ödeal uygulaması, Ödeal backend'ine sepet referans kodunu iletir.

4. 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.

   

5. Ürün Bilgilerinin Aktarılması
   Sepetten alınan bilgilere istinaden ürün detay ve tutarlar Ödeal'a aktarılır.

6. Fatura Bilgilerinin Belirlenmesi
   Sepetten gelen bilgilere istinaden fatura bilgilerinin ne olacağı da bu aşamada Ödeal'a iletiliyor olur.

   FATURA BİLGİSİ DETAYI

   • 9900 TL altında: TCKN: 11111111111 ve "Nihai Tüketici" bilgileriyle fatura oluşturulabilir
   • 9900 TL üstünde: Gerçek bir TCKN veya VKN'ye ihtiyaç bulunmaktadır

   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.

   

7. Ödeme İşleminin Bankaya İletilmesi
   Alınan sepet detaylarına istinaden ödeme işlemi TechPos aracılığıyla bankaya iletilir.

   

8. Ödeme Sonucunun İletilmesi
   Bankadan alınan cevaba istinaden Ödeal, ödeme işleminin cevabını iş ortağının açmış olduğu (callback) servisleri aracılığıyla işlem sonucunu ilgili iş ortağı URL'ine gönderir.

9. 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)

10. 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.

📊 İşlem Akış Diyagramları

Satış İşlemi Akışı

İptal İşlemi Akışı

ÖNEMLI KOŞULLAR

• E-fatura oluşmuşsa eğer işlem ve fatura iptal edilemez
• İptal işleminin yapılabilmesi için gün sonu alınmamış olması gerekmektedir

İPTAL İŞLEMİ DETAYLARI

İptal işlemi için aşağıdaki koşullar geçerlidir:

1. Gün Sonu Kontrolü: İşlem henüz gün sonu alınmamış olmalıdır
2. E-Fatura Durumu: E-fatura oluşturulmuşsa işlem iptal edilemez
3. Callback Bildirimi: İptal başarılı olduğunda paymentCancelledUrl üzerinden bildirim yapılır
4. Görsel Gösterim: İptal edilen işlemler menüde kırmızı renk ile gösterilir

---

🔗 İlgili Kaynaklar

• Konfigürasyon Servisi
• Callback Servisleri
• E-Fatura Entegrasyonu