Test Kartları Ortak Bilgiler
Test kartı, gerçek bir hesaba bağlı olmayan ve yalnız ödeme kuruluşunun test ortamında (sandbox) onay ya da ret yanıtı üreten kart numarasıdır. Her kuruluş kendi listesini yayımlar; bir test kartı yanıt vermiyorsa numaranın kendi kuruluşunuzun listesinden alındığını ve isteğin test ortamı adresine gittiğini kontrol edin.
SKT, CVV ve 3D test değeri kuruluşun test dokümantasyonunda yazar; bazı test ortamları ileri tarihli herhangi bir SKT ve CVV kabul eder, bazıları sabit değer verir.
Test değerleri yalnız test ortamı içindir ve canlı ortamda geçerli değildir. Kart listesi ile doğrulama bilgileri, çalışılacak ödeme kuruluşunun çözümüne göre değişebilir.
Test senaryoları
Kart numaraları kuruluşunuzun test listesinde yazar; tablo, o listede arayacağınız etiketi ve kodunuzda doğrulayacağınız davranışı gösterir.
| Senaryo |
Kuruluşun listesinde arayacağınız etiket |
Yaygın yanıt kodu |
Kodunuzda doğrulayın |
| Başarılı ödeme |
başarılı / approved |
— |
siparişi sunucu doğrulamasından sonra kapatma |
| Yetersiz bakiye |
yetersiz bakiye / insufficient funds |
51 |
sepeti koruma, mesaj |
| Hatalı CVV |
geçersiz CVV / invalid cvc |
82 |
mesaj, yeniden deneme |
| Süresi dolmuş kart |
süresi dolmuş / expired card |
54 |
mesaj |
| Genel ret |
işlem onaylanmadı / do not honour |
05 |
kullanıcıyı bankasına yönlendiren mesaj |
| 3D doğrulama başarısız |
3D başarısız |
kuruluşa göre |
siparişi beklemede bırakmama |
Kodlar yaygın karşılıklardır; kesin kod dokümantasyonunuzda yazar. Ret durumunda dönen kodun karşılığını POS hata kodları sayfasından bulabilirsiniz.
3D Secure Test Bilgileri
Sandbox ortamında 3D Secure adımı canlıdakiyle aynı sırayla çalışır: istekten sonra kullanıcı doğrulama sayfasına gider, kuruluşun verdiği test değeri girilir ve sonuç dönüş (callback) adresinize gelir.
- Doğrulama şifresi: Test kartlarının 3D Secure ekranında kuruluşun verdiği test değeri girilir.
- Yönlendirme: Ödeme isteği gönderildikten sonra kullanıcı 3D Secure sayfasına yönlendirilir; doğrulama burada tamamlanır.
- Dönüş adresi: Doğrulama bittiğinde belirttiğiniz callback adresine geri dönülür. Alanlar ve imza doğrulaması için webhook ve callback sayfasına bakın.
- Başarısız kartlar: Reddedilen senaryolarda da doğrulama adımı çalışır; hata, doğrulamadan sonra döner. Bu yüzden "3D Secure tamamlandı" bilgisini tek başına başarı sayımı olarak kullanmayın.
Sandbox Erişimi ve API Anahtarları
Test kartlarını kullanabilmek için önce sandbox erişiminizin tanımlanmış olması gerekir.
- Erişim: Sandbox ortamı ve test anahtarları, başvurunuz tamamlanıp hesabınız açıldıktan sonra tanımlanır.
- Test ortamı adresi: Sandbox uç nokta adresi, hesabınız açıldığında iletilen dokümantasyonda belirtilir.
- Anahtar biçimi: Test ve canlı anahtarlar ayrıdır. Anahtar biçimi ve önekleri seçilen ödeme kuruluşunun çözümüne göre değişir.
- Panel: Test işlemlerinizi takip edebileceğiniz panel erişim bilgileri hesap açılışında iletilir.
- Kurulum adımları: Ortamın hazırlanması için test ortamı (sandbox) sayfasına bakın.
Test Senaryolarını Planlama
Kart listesini tek tek denemek yerine, entegrasyonun kritik uçlarını kapsayan kısa bir senaryo listesi çıkarmak zaman kazandırır.
- 1) Başarılı tek çekim: siparişi yalnız sunucu tarafı doğrulamadan sonra kapatın; tutarı ve para birimini karşılaştırın.
- 2) Yetersiz bakiye (yaygın kod 51): sepet korunuyor, kullanıcı anlaşılır bir mesaj görüyor.
- 3) Hatalı CVV (yaygın kod 82) ve süresi dolmuş kart (yaygın kod 54): her biri için ayrı mesaj gösteriliyor.
- 4) 3D doğrulamada vazgeçme ya da başarısız doğrulama: sipariş beklemede kalmıyor, zaman aşımıyla düşüyor.
- 5) Aynı bildirimin iki kez gelmesi: sipariş yalnız bir kez kapanıyor.
- 6) Yanıt gelmemesi ya da zaman aşımı: işlem durumu sorgusuyla kesinleştiriliyor.
- 7) Taksit kullanacaksanız: taksitli istek deneniyor; taksit kapalı terminalde dönen hata (yaygın kod 58) görülüyor.
- 8) İade ve iptal kullanacaksanız: gün içi iptal ile sonraki gün iade ayrı ayrı deneniyor.
- 9) Günlükler: kart numarası ve CVV kaydedilmiyor, ham yanıt kodu saklanıyor.
Hazır istek gövdeleri ve dil bazlı örnekler için örnek kodlar sayfasını kullanabilirsiniz.
Tam entegrasyon planı (webhook, idempotency, iade): Sandbox test planınızı çıkarın →
Canlıya Geçiş ve İlgili Sayfalar
Test senaryoları doğrulandıktan sonra canlı anahtarlara geçilir ve akış gerçek kart işlemlerine açılır. Test kartları canlı ortamda çalışmaz; geçiş öncesinde koda gömülü test değerleri kalmadığından emin olun.
Adım adım kurulum için entegrasyon kılavuzu, uç noktalar ve alan açıklamaları için API dokümantasyonu sayfalarına bakabilirsiniz. Hazır paketlerle çalışmak isterseniz PHP, Node.js ve Python SDK sayfaları başlangıç için uygundur.
