Ana içeriğe geç

Test

Test modu​

Entegrasyonu sandbox'ta (https://sandbox.odemehub.com) geliştirin: orada her çalışma alanı her zaman test modundadır ve bütün modüller açıktır. Aşağıdakiler hem sandbox için hem de canlı adresteki (https://app.odemehub.com) test modu için geçerlidir.

Canlı adreste test ve canlı için ayrı adres ya da ayrı anahtar yoktur. Çalışma alanı test modundayken istekler, ödeme hesaplarının test ayarlarıyla işlenir. Mod panelden değiştirilir; yeni açılan çalışma alanı test modunda başlar. Bkz. Ortamlar ve Adresler.

Aynı BASE_URL, X-Api-Key ve gizli anahtar test ve canlı modda aynen kullanılır; mod değişikliği için istekte bir alan yoktur.

Test kartları​

Test kartları ödeme hesabının sağlayıcısına göre değişir. Test modunda gateway'in ödeme sayfası (sipariş, abonelik ve ödeme linkindeki checkout_url) ödemenin geçeceği hesabın sağlayıcısına ait test kartlarını gösterir.

Test Ödemesi hesabı​

Test Ödemesi, hiçbir ödeme kuruluşuna bağlanmayan bir ödeme hesabıdır. Sağlayıcı API bilgisi istemez. Entegrasyonu, bir ödeme kuruluşuyla anlaşma yapmadan ve sağlayıcının test ortamına bağlı kalmadan uçtan uca denemek için kullanılır. Hesap panelde Ödeme Hesapları altından eklenir; doldurulacak alan yoktur.

Gerçek para hareketi olmaz. Hesap yalnızca test modunda yanıt verir: canlı modda her ödeme Test Ödemesi yalnızca Test ortamında çalışır. mesajıyla reddedilir.

Test kartları​

Kart numarasıSon kullanmaCVV
552608000000000612/2030000
460345000000000012/2030000

Bunların dışındaki kartlar Kart bilgileri hatalı. Test Ödemesi yalnızca test kartlarını kabul eder. mesajıyla reddedilir.

Davranış​

Uç / AkışSonuç
regular-payment, test kartıresult.successful: true, Ödeme başarıyla alındı.
regular-payment, başka kartresult.successful: false
secure-payment, test kartıresult.successful: true, result.redirect_url dolu. Adres, bankanın 3D adımının yerine Onayla ve Reddet düğmeleri olan bir sayfa sunar.
secure-payment, başka kartresult.successful: false, redirect_url null.
3D sayfasında Onaylacallback_url adresine başarılı dönüş; retrieve-payments successful: true.
3D sayfasında Reddetcallback_url adresine başarısız dönüş, mesaj 3D doğrulama reddedildi.
Ödeme sayfası (checkout_url)Ödeme secure-payment ile aynı akışta alınır.

Test Ödemesi hesabı kart saklamaz, iade ve iptal almaz. Bu yüzden şu istekler 422 döner:

İstekMesaj
create-saved-card ya da ödeme isteğinde card.should_save: trueBu ödeme hesabı kart saklamayı desteklemiyor.
create-subscriptionBu ödeme hesabı kart saklamıyor; abonelik açılamaz. (Test Ödemesi çalışma alanının varsayılan hesabıysa ve istekte hesap belirtilmemişse: Çalışma alanınızın varsayılan ödeme hesabı kart saklamıyor; abonelik açılamaz.)
refund-paymentBu ödeme hesabı İade işlemini desteklemiyor.
cancel-paymentBu ödeme hesabı İptal işlemini desteklemiyor.

Moda bağlı kayıtlar​

KayıtKural
Kayıtlı kartSaklandığı modda kullanılabilir. Diğer modda transaction.saved_card_token ile ödeme 422 döner: Kayıtlı kart bu ortamda saklanmamış.
Abonelikİlk ödemenin yapıldığı moda bağlanır (subscription.is_test). Yenilemeler yalnızca aynı modda saklanmış varsayılan karttan çekilir.
retrieve-saved-cardsHer iki modda saklanan kartları birlikte listeler.
İşlem, sipariş, abonelik, ödeme linkiYanıtlardaki is_test alanı kaydın hangi modda oluştuğunu (sipariş ve abonelikte ödendiği modu; ödeme linkinde çalışma alanının şu anki modunu) gösterir.

Test senaryoları​

SenaryoUç / Kontrol
Başarılı regular ödemeregular-payment → 200, result.successful: true.
Reddedilen ödeme200, result.successful: false, result.message dolu.
3D başarılı / başarısız dönüşsecure-payment → redirect_url → callback_url POST → retrieve-payments.
3D süresi dolan ödemeredirect_url 15 dakika açılmaz → açıldığında callback_url'e successful=0; retrieve-payments successful: false.
Aynı dönüşün tekrarıAynı transaction_token ile işleyiciyi iki kez çağırın.
Doğrulama hatasıHatalı tutar ("100,10") → 422, result.errors["transaction.amount"].
İmza hatasıYanlış X-Signature → 401, İmza doğrulanamadı.
Zaman damgası hatası5 dakikadan eski X-Timestamp → 401, İmzanın zaman damgası eksik ya da izin verilen aralığın dışında.
Bulunamayan kayıtVar olmayan token ile retrieve-payments → 200, boş payments; refund-payment → 404, Bu işlem bulunamadı.
Tekrarlanan create-orderAynı referansla iki kez create-order → iki ayrı order.token, ikisi de 200; retrieve-orders reference ile iki siparişi döndürür. Sisteminiz kayıtları token'la eşleştirmelidir.
Kısmi ve tam iaderefund-payment amount ile, sonra amount olmadan.
Kısmi iadeden sonra iptalcancel-payment → 422.
Webhook imza doğrulamaDeğiştirilmiş gövde ile işleyiciniz SignatureException/SignatureError vermelidir.