Ödeme Akışı

Bu sayfa bir tahsilatın baştan sona nasıl ilerlediğini anlatır. Web ve mobil arasındaki farkı ve tek deneme kuralını burada görürsünüz.

Entegrasyon iki taraflıdır. Sunucu tarafında siz ödeme isteğini oluşturur ve sonucu doğrularsınız. Tarayıcı tarafında kart sahibi kartını LydiaGate 3DS Relay’e iletir ve 3D Secure doğrulamasını tamamlar. Bankanın 3D Secure adımı, banka geri bildirimi ve tahsilat LydiaGate tarafındadır.

Akış

Kartsız taksit görünümü. Kart girilmeden önce sunucunuz POST /v1/installment-options/overview ile terminalinizdeki bütün taksit seçeneklerini ve kart tipine göre komisyon tutarlarını alır. Ödeme ekranınız bu tabloyu kart sahibine gösterir. Ayrıntı: Kartsız Taksit Görünümü.
Taksit ve toplam tutar sorgusu. Kart sahibi kartının ilk 8 hanesini girer. Sunucunuz POST /v1/installment-options ile taksit seçeneklerini ve her seçeneğin toplam tutarını alır. Ayrıntı: Taksit ve Toplam Tutar Sorgusu.
Ödeme isteği. Kart sahibi bir seçenek seçer. Sunucunuz POST /v1/payments ile seçilen toplam tutarı, taksit sayısını, terminal kimliği olan terminalId değerini ve dönüş adresi olan returnUrl değerini gönderir. Bu istekte kart yoktur. Yanıtta paymentCode, initiated durumu, paymentRef ve handoffUrl gelir. paymentCode ödeme kodu, paymentRef ödeme referansı, handoffUrl yönlendirme adresidir. Ayrıntı: Ödeme Oluştur.
LydiaGate 3DS Relay’e geçiş. Kart sahibinin tarayıcısı, topladığınız kartı ve paymentRef değerini handoffUrl adresine bir formla POST isteğiyle gönderir. Ayrıntı: Kart Handoff.
3D Secure. LydiaGate 3DS Relay bankanın 3D Secure adımını başlatır. Kart sahibi bankasının doğrulama sayfasında doğrulamayı tamamlar. Bu adımlar kendiliğinden yürür. Siz bir form kurmazsınız.
Banka geri bildirimi ve tahsilat. Banka 3D Secure sonucunu LydiaGate’e bildirir. LydiaGate tahsilatı yapar ve komisyonu bankaya bildirir.
Geri dönüş. LydiaGate 3DS Relay kart sahibinin tarayıcısını HTTP 303 yönlendirmesiyle sizin returnUrl adresinize gönderir. Bu adrese gelen bilgi kesin sonuç değildir.
Sonucu doğrulama. Kesin durumu GET /v1/payments/{paymentCode} ve webhook ile öğrenirsiniz. Borcu kapatma kararını bu kesin sonuca göre verirsiniz.

Düz oklar istektir. Kesikli oklar yanıttır. Numaralar alttaki listeyle aynıdır.

Web ve mobil

Akış iki kanalda da aynıdır. Tek fark tarayıcı bağlamını nasıl yarattığınızdır.

Web: kart sahibinin tarayıcısı handoffUrl adresine bir formla POST isteği gönderir. Dönüşte tarayıcı HTTP 303 yönlendirmesiyle returnUrl adresine gider.
Mobil: uygulamanız kartı kendi ekranında toplar. Sonra bir WebView açar. Uygulamanız kartı ve paymentRef değerini handoffUrl adresine POST isteğiyle gönderir. 3D Secure WebView içinde tamamlanır. Sonunda WebView returnUrl adresine iner.

Tek deneme: bir ödeme, bir kart denemesidir

Bir paymentRef değerini tek denemelik kabul edin. Teknik olarak aynı ödemede sınırlı sayıda kart denemesine izin verilir. Yine de entegrasyonunuzu “tekrar = yeni ödeme” üzerine kurun. Kart sahibi 3D Secure adımını yarıda bırakır ya da 3D Secure başarısız olursa, o ödeme failed ya da expired olur ve paymentRef yeniden kullanılamaz. Tekrar denemek için yeni bir ödeme isteği oluşturursunuz: POST /v1/payments.

Kart deneme sınırı. LydiaGate, tek bir ödemeye yapılan kart denemelerini kötüye kullanıma karşı sınırlar. Aynı ödeme için art arda çok sayıda farklı kart denenirse ödeme kalıcı olarak failed olur ve paymentRef bir daha kullanılamaz. Bu nedenle her kart denemesini ayrı bir ödeme olarak ele alın.

Hangi denemeler sayılır: karta bağlı olarak reddedilen her deneme sayılır. Bankanın 3D Secure adımında reddedilen kart sayılır. Denemenin bankaya hiç ulaşmadan LydiaGate doğrulamasında reddedilmesi de sayılır. İki örnek vardır. Birinci örnekte seçilen taksit o kart için kullanılamaz ve installment_not_allowed döner. İkinci örnekte kartın tipi terminalinizin banka bağlantısında desteklenmez ve virtual_pos_card_type_not_supported döner.

Sonuçlar ayrılır. 3D Secure akışının kendisinde başarısız olan bir denemede ödeme failed olur ve paymentRef biter. Deneme daha 3D Secure başlamadan reddedilirse ödeme initiated kalır. Kart sahibi aynı ödemede başka bir kart deneyebilir. Her deneme haktan düşer. Hak bitince ödeme failed olur ve card_attempt_limit_exceeded döner. Bankanın 3D Secure’ü başlatmayı kart düzeyinde bir nedenle reddetmesi de bu gruptadır. Bu durumda ödeme initiated kalır ve payment_declined döner.

Kartla ilgisi olmayan retler hak tüketmez. Üç grup vardır. Banka bağlantısının ya da ödeme sağlayıcısının geçici olarak kullanılamaması: virtual_pos_inactive, psp_inactive. Eşzamanlı isteklerden doğan çakışmalar: payment_prepare_already_started, payment_ref_invalid. Banka bağlantınıza tanımlı bir limitin dolması: pos_per_tx_limit_exceeded, pos_daily_limit_exceeded, pos_weekly_limit_exceeded, pos_monthly_limit_exceeded, pos_time_window_limit_exceeded. Limit retleri 3D Secure başlangıcında oluşursa kart sahibi genel bir hata sayfası görür. Ret sunucunuza error.code olarak dönmez. Ödeme initiated kalır ve aynı paymentRef ile tekrar denenebilir.