Kart Handoff

Bu sayfa kartı LydiaGate 3DS Relay’e nasıl ileteceğinizi anlatır. Web ve mobil için ayrı örnek vardır.

Kartı kendi ödeme ekranınızda toplarsınız. Sonra kart sahibinin tarayıcısı, kartı ve ödeme referansını handoffUrl adresine gönderir. Ödeme referansı paymentRef, yönlendirme adresi handoffUrl alanıdır. İkisini de POST /v1/payments yanıtından alırsınız. handoffUrl değerini yanıttan olduğu gibi kullanın.

LydiaGate Handoff, kartın kart sahibinin tarayıcısından 3DS Relay’e iletilmesidir.

Web: form gönderimi

Kart sahibinin tarayıcısı, handoffUrl alanındaki yönlendirme adresine bir form ile POST isteği gönderir. Bu örnekte kart maskelidir. Gerçek değer kart sahibinin tarayıcısının belleğinden gelir. Gerçek kart numarasını dokümana ya da loga yazmayın.

<form id="lydiagate-handoff" method="POST" action="https://pay.lydiagate.example/checkout">
  <input type="hidden" name="paymentRef" value="pr_3Kd9xQ1w2E" />
  <input type="hidden" name="pan" value="4242 42** **** 4242" />
  <input type="hidden" name="expireMonth" value="12" />
  <input type="hidden" name="expireYear" value="28" />
  <input type="hidden" name="cv2" value="***" />
</form>
<script>document.getElementById('lydiagate-handoff').submit();</script>

Gönderimden sonra her şey LydiaGate 3DS Relay’de yürür. Relay bankanın 3D Secure adımını başlatır. Kart sahibi 3D Secure doğrulamasını tamamlar. LydiaGate sonucu işler. Sonra kart sahibinin tarayıcısı HTTP 303 yönlendirmesiyle returnUrl adresinize döner. Banka formunu siz kurmazsınız. Otomatik gönderilen formu LydiaGate 3DS Relay üretir.

Mobil: WebView

Mobil uygulamada akış aynıdır. Tek fark, tarayıcı bağlamını bir WebView ile yaratmanızdır.

1. Kartı uygulamanızın kendi ekranında toplayın.
2. Bir WebView açın.
3. Kart ile paymentRef değerini handoffUrl adresine POST isteğiyle gönderin:
   • Android: WebView.postUrl(handoffUrl, body). Gövde, application/x-www-form-urlencoded kodlanmış paymentRef ve kart alanlarıdır.
   • iOS: httpMethod = "POST" ayarlı bir URLRequest ile WebView’i yükleyin.
4. 3D Secure WebView içinde tamamlanır. Sonunda WebView sizin returnUrl adresinize iner.

Not

Navigasyonu kendiniz dinleyin. LydiaGate tarafında mobile özel hiçbir şey yoktur. Standart 303 → returnUrl dönüşü yapılır. Deep-link kullanılmaz. Uygulamanız WebView navigasyonunu dinler ve returnUrl adresine ulaşıldığını kendisi tespit eder. WebView’de JavaScript ve çerez açık olmalıdır. Aksi halde 3D Secure çalışmaz.

Başarısız 3D Secure yeni ödeme demektir

Bir paymentRef tek denemeliktir. 3D Secure başarısız olur ya da kart sahibi sayfayı terk ederse ödeme failed ya da expired olur. Aynı paymentRef yeniden kullanılamaz. Tekrar denemek için yeni bir ödeme oluşturursunuz. Ayrıntı: Ödeme Akışı.