Ortamlar
Base URL’ler
Bölüm başlığı “Base URL’ler”| Ortam | API Base URL |
|---|---|
| Canlı (prod) | https://api.lydiagate.com |
| Test | onboarding’de verilir |
API öneki
Bölüm başlığı “API öneki”Tüm uç noktalar /v1 öneki ile sürümlenir. Örnek tam adres:
https://api.lydiagate.com/v1/paymentsAPI yüzeyi (api.lydiagate.com) sunucudan-sunucuya çağrılar içindir (API anahtarı ile). Alıcının tarayıcısının/WebView’inin konuştuğu Lydia Gate 3DS Relay ayrı bir origindir (pay.*) ve aşağıda açıklanır.
Lydia Gate 3DS Relay ve dönüş
Bölüm başlığı “Lydia Gate 3DS Relay ve dönüş”Kartı kendi checkout’unuzda toplar, ardından alıcıyı Lydia Gate 3DS Relay’e yönlendirirsiniz. POST /v1/payments isteğinin gövdesi kart içermez ve yanıtında bir handoffUrl döner: bu, alıcının tarayıcısını/WebView’ini kart + paymentRef ile yönlendireceğiniz Lydia Gate 3DS Relay adresidir (pay.* origin). handoffUrl’i yanıttan olduğu gibi kullanın; sabit bir değer varsaymazsınız. Banka 3D Secure devri bu yüzeyde yürür.
3D tamamlandıktan sonra Lydia Gate 3DS Relay alıcının tarayıcısını/WebView’ini, POST /v1/payments isteğinde verdiğiniz returnUrl’ine 303 ile yönlendirir. returnUrl üzerinden taşınan sonuç bilgisi, istemci (tarayıcı) üzerinden geldiği için nihai/güvenilir sonuç olarak kabul edilmemelidir; kesin sonucu daima GET /v1/payments ve webhook ile alırsınız.
Web ve mobil arasında Lydia Gate tarafında fark yoktur (web: native tarayıcı 303; mobil: WebView aynı 303’e iner); mobilde deep-link kullanılmaz. Detay: Kart Handoff.
Ödemenin 3D’yi tamamlamak için geçerli süresi 30 dakikadır; bu süre içinde tamamlanmazsa ödeme expired durumuna geçer.
Sonraki adım
Bölüm başlığı “Sonraki adım”- Hızlı Başlangıç: ilk ödemenizi oluşturun
- Test Kartları: test ortamında kullanacağınız kartlar ve senaryolar