İçeriğe geç
LydiaGateLydiaGateBelediye

Ortamlar ve Ağ Erişimi

Bu sayfa test ortamının API ve panel adreslerini verir. Canlı ortamın adresleri bu dokümanda yer almaz. Hesap açılışı tamamlanınca LydiaGate canlı adresleri size iletir. Kurumunuzun ağında açılması gereken alan adlarını da burada bulursunuz.

İki ortam

Bölüm başlığı “İki ortam”

Test ve canlı ortam birbirinden tamamen ayrıdır. Her birinin kendi hesabı, API anahtarı, paneli ve adresi vardır. Test ortamında gerçek para hareketi olmaz. Test ortamında yalnız test kartı çalışır.

Yüzey Test adresi
API https://test-api.lydiagate.com
LydiaGate 3DS Relay https://testpay.lydiagate.com
İş Ortağı Paneli https://test-panel.lydiagate.com

Canlı ortamın API, 3DS Relay ve panel adresleri hesap açılışı tamamlanınca size iletilir. Entegrasyonunuzda bu üç adresi yapılandırma değeri olarak tutun. Böylece canlıya geçişte yalnız adresleri değiştirirsiniz.

API öneki

Bölüm başlığı “API öneki”

Tüm uçlar /v1 önekiyle sürümlenir. Örnek tam adres:

https://test-api.lydiagate.com/v1/payments

API yüzeyi sunucunuzdan yapılan çağrılar içindir ve API anahtarıyla çalışır. Kart sahibinin tarayıcısı API ile konuşmaz. Tarayıcı LydiaGate 3DS Relay ile konuşur.

LydiaGate 3DS Relay ve dönüş

Bölüm başlığı “LydiaGate 3DS Relay ve dönüş”

POST /v1/payments isteğinin gövdesinde kart yoktur. Yanıtta handoffUrl alanı döner. Bu alan LydiaGate 3DS Relay’in yönlendirme adresidir. Kart sahibinin tarayıcısını bu adrese, kart ve ödeme referansı olan paymentRef ile yönlendirirsiniz. handoffUrl değerini yanıttan olduğu gibi kullanın. Sabit bir adres varsaymayın.

3D Secure tamamlanınca 3DS Relay, kart sahibinin tarayıcısını dönüş adresiniz olan returnUrl adresine HTTP 303 yönlendirmesiyle gönderir. Bu adrese taşınan bilgi kart sahibinin tarayıcısından geldiği için kesin sonuç sayılmaz. Kesin sonucu her zaman GET /v1/payments/{paymentCode} sorgusu ve webhook ile alırsınız.

Web ve mobil arasında LydiaGate tarafında fark yoktur. Mobilde WebView aynı 303 dönüşüne iner. Deep-link kullanılmaz. Ayrıntı: Kart Handoff.

Kart sahibinin 3D Secure adımını tamamlaması için 135 dakika süresi vardır. Bu süre içinde tamamlanmayan ödeme expired durumuna geçer.

Kurumunuzun ağında açılacak alan adları

Bölüm başlığı “Kurumunuzun ağında açılacak alan adları”

Entegrasyonda üç tür bağlantı vardır:

  1. Sunucunuzdan LydiaGate API’sine giden bağlantı.
  2. Kart sahibinin tarayıcısından LydiaGate 3DS Relay’e ve kartın bankasının 3D Secure sayfasına giden bağlantı.
  3. LydiaGate’ten sizin webhook adresinize gelen bağlantı.

Hepsi HTTPS kullanır. LydiaGate adreslerinde port 443’tür. Webhook adresinizde port belirtmezseniz 443 kullanılır.

Yön Kaynak Hedef Ortam
Giden Sunucunuz test-api.lydiagate.com Test
Giden Kart sahibinin tarayıcısı testpay.lydiagate.com Test
Giden Kart sahibinin tarayıcısı Kartın bankasının 3D Secure sayfası Test ve canlı
Giden Personelinizin tarayıcısı test-panel.lydiagate.com Test
Gelen LydiaGate Sizin webhook adresiniz Test ve canlı

Canlı ortamın üç alan adı hesap açılışı sonrası size iletilir. Güvenlik duvarınıza o zaman aynı yönlerle eklersiniz.

Sabit IP yoktur

Bölüm başlığı “Sabit IP yoktur”

LydiaGate sabit bir çıkış IP adresi taahhüt etmez. Adres değişebilir ve paylaşılmaz. Güvenlik duvarınızda IP adresine göre kural yazmayın. Alan adına göre kural yazın.

Webhook adresinizi belirli IP adreslerine kısıtlamayın. Gelen webhook’un LydiaGate’ten geldiğini imza doğrulamasıyla anlarsınız. İmza doğrulama: Webhooks.

Sonraki adımlar

Bölüm başlığı “Sonraki adımlar”