App2App

İş ortağı mobil uygulamasından Ödeal uygulamasını uyandırıp ödeme tamamlandıktan sonra ödeme sonucunun tekrar iş ortağı uygulamasına gönderilmektedir.

İş ortağı uygulamasında hazırlanan sepet, Ödeal mobil uygulamasını sadece sepete ait tekil referans kodu ile açılması yeterli olacaktır. İş 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ş 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.

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

📘
App2App ile işlem almaya başlamadan önce dikkat edilmesi gereken ö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.
NOT: Konfigürasyon tanımı tek seferliğe mahsus yapılmaktadır. Konfirüasyon tanımının önemi işlemlerin sağlanması için parameterlerin tanımlı olması gerekmektedir. Örn: basketUrl bilgisi Sepet bilgisinin alınacağı URL bilgisidir. Eğer ki Geri Bildirim'in altındaki servisler kullanılacaksa burada tanımlamak gerekmektedir.
2- Çalışan tanımı :
İşlem alacak kullanıcıların tanımlanmasıdır. Cihaz üzerinden yapılabileceği gibi Ödeal Portal üzerinden de yapılabilir. Bu tanımla işyeri yetkilisi aslında çalışanlarına cihaza giriş yapabilecekleri hesapları tanımlamış olur.

Ödeal ile App2App profilde üyelik süreci nedir?

İş ortağı Ödeal'a (iş modeline bağlı olarak) satış veya lead kaydı gönderir.
Ö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)
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 talebi yapılır.
Cihaz gönderimi gerçekleşir.
Ü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.
Üyeye ulaşmış cihaza tekniker gönderilerek kurulumlar yapılır ve cihaz işleme hazır hale gelir.

İşlem adımları (App2App) :

İşlem iş ortağı uygulamasından başlatılır yani sepet oluşturulur.
İş ortağı uygulamasından ödeme adımı için sepet id bilgisiyle tahsilat işlemi ödeal uygulamasına gönderilir.
Uyandırılan Ödeal uygulaması Ödeal backend’ine sepet referans kodu’nu iletir.
Ö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.
Sepetten alınan bilgilere istinaden ürün detay ve tutarlar ödeal’a aktarılır.
Sepetten gelen bilgilere istinade fatura bilgilerinin ne olacağı da bu aşamada Ödeal’a iletiliyor olur. Örneğin 6900 TL altında bir işlem için TCKN: 11111111111 ve “Nihai Tüketici” bilgileriyle bir fatura oluşturulabilirken tutar 6900 TL üstünde ise bir 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 GİB üzerinden sorgular ve gelen bilgilere göre fatura bilgilerini hazırlamış olur.
Alınan sepet detaylarına istinaden ödeme işlemi techpos aracılığıyla bankaya iletilir.
Bankadan alınan cevaba istinaden Ödeal ödeme işleminin cevabını yine iş ortağının açmış olduğu (callback) servisleri aracılığıyla işlem sonucunu ilgili iş ortağı URL’ine gönderir.
İşlem başarılıysa işleme ait e-belgenin hazırlanması için Ödeal efatura oluşturma işlemini başlatır. (Hazırlanması belli bir süre sonra olabilir)
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.

Satış işleminin akışı :

İptal işleminin akışı :