Test Kartları

Entegrasyonunuzu canlıya almadan önce test ortamında uçtan uca deneyin. Bu sayfadaki kartlar sağlayıcıların test ortamlarına aittir; gerçek kart değildir, gerçek para hareketi oluşturmaz.

Yalnızca test ortamı

Bu kartlar canlı ortamda çalışmaz. Test ortamının base URL’i ve test API anahtarınız entegrasyon onboarding’i sırasında iletilir — bkz. Ortamlar. Canlı anahtarınızla (ldg_live_…) test kartı kullanmayı denemeyin.

Kartlar

Test kartları terminalinizin bağlı olduğu ödeme sağlayıcısına göre değişir: bir sağlayıcının test kartı diğerinde çalışmaz, reddedilir. Aşağıdan yalnızca kendi sağlayıcınızın başlığındaki kartları kullanın.

Hangi sağlayıcıya bağlısınız?

Terminalinizin bağlı olduğu sağlayıcının adı, aşağıdaki başlıklarda yazdığı biçimiyle onboarding sırasında size bildirilir. Emin değilseniz kart denemeden önce onboarding kanalınızdan teyit edin — yanlış setle yapılan denemeler kart-deneme hakkınızı tüketir (bkz. Ödeme Akışı).

NestPay (Halkbank)

Marka	Kart numarası	Son kullanma	CVV	3D Secure şifresi
Visa	4531444531442283	12/26	001	a
Mastercard	5818775818772285	12/26	001	a

3D Secure şifresi, kart handoff’undan sonra bankanın 3D doğrulama sayfasında sorulan şifredir. NestPay test ortamında tek karakterdir: a.

HalkÖde (Halkbank)

Marka	Kart numarası	Son kullanma	CVV	3D Secure kodu
Mastercard	5430811516419115	08/30	322	123456

HalkÖde test ortamında 3D doğrulama adımı 6 haneli bir kod ister (SMS/OTP alanı); test kartı için bu kod 123456’dır.

Değerler sağlayıcıya aittir

Her iki set de ilgili sağlayıcının test ortamı tarafından tanımlanır ve zaman içinde güncellenebilir — özellikle son kullanma tarihi. Kart beklenmedik şekilde reddediliyorsa güncel seti onboarding kanalınızdan teyit edin.

Senaryolar

Farklı sonuçları CVV değerini değiştirerek ya da 3D adımında farklı davranarak tetikleyebilirsiniz:

Senaryo	Nasıl tetiklenir	Beklenen durum
Başarılı ödeme	Kartı sağlayıcınızın tablosundaki değerlerle gönderin, 3D adımını doğru şifre/kodla tamamlayın	captured
3D doğrulama başarısız	3D sayfasında yanlış şifre/kod girin	failed
3D’yi terk etme	3D sayfasını kapatın, işlemi tamamlamayın	expired
Limit yetersiz (yalnız NestPay)	CVV alanına 510 gönderin	failed (banka reddi)
İşleme kapalı kart (yalnız NestPay)	CVV alanına 000 gönderin	failed (banka reddi)
Süre aşımı	Ödemeyi oluşturup süre penceresi boyunca (NestPay’de 30 dakika; HalkÖde terminallerinde 135 dakika) handoff yapmayın	expired

CVV ile tetiklenen banka-reddi senaryoları NestPay test ortamına özgüdür; HalkÖde test ortamında karşılıkları tanımlı değildir — HalkÖde’de red senaryosu denemeniz gerekiyorsa onboarding kanalınıza danışın.

Durumların anlamı ve geçişleri: Ödeme Yaşam Döngüsü. Red sebeplerinin karşılığı: Hata Kodları.

Testte sık karşılaşılanlar

Kartı doğru sağlayıcının setinden seçin. Bir sağlayıcının test kartı diğerinin test ortamında tanımlı değildir; gönderirseniz banka reddi ya da doğrulama hatası alırsınız. Karta bağlı her ret, o ödemenin kart-deneme hakkından düşer.

Peş peşe 3D denemesi reddediliyor. Banka tarafında 5 dakikalık pencerede yapılabilecek başarılı 3D işlem sayısı sınırlıdır; hızlı ardışık denemelerde üçüncü işlem reddedilebilir. Denemeler arasında birkaç dakika bırakın.

Taksit. Test setiyle tek çekim (installment: 1) ile başlayın. Taksitli işlemler kartın ve terminalin taksit desteğine bağlıdır; test kartlarıyla her taksit adedi kabul edilmeyebilir. Terminalinize tanımlı taksit seçeneklerini Taksit Seçenekleri ile sorgulayabilirsiniz.

Sonucu returnUrl’den okumayın. returnUrl’e düşen bilgi alıcının tarayıcısından geldiği için nihai kabul edilmez. Test sırasında da kesin sonucu GET /v1/payments ya da webhook ile doğrulayın.

Kartı doğru yüzeye gönderin. Kart numarası POST /v1/payments gövdesine girmez; yalnızca alıcının tarayıcısından handoffUrl’e POST edilir. Ayrıntı: Kart Handoff.

Sonraki adımlar

• Hızlı Başlangıç: ilk ödemenizi oluşturun
• Kart Handoff: kartı Lydia Gate 3DS Relay’e iletme (web + mobil)