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 kullanma | CVV |
|---|---|---|
5526080000000006 | 12/2030 | 000 |
4603450000000000 | 12/2030 | 000 |
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 kart | result.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 kart | result.successful: false, redirect_url null. |
| 3D sayfasında Onayla | callback_url adresine başarılı dönüş; retrieve-payments successful: true. |
| 3D sayfasında Reddet | callback_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:
| İstek | Mesaj |
|---|---|
create-saved-card ya da ödeme isteğinde card.should_save: true | Bu ödeme hesabı kart saklamayı desteklemiyor. |
create-subscription | Bu ö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-payment | Bu ödeme hesabı İade işlemini desteklemiyor. |
cancel-payment | Bu ödeme hesabı İptal işlemini desteklemiyor. |
Moda bağlı kayıtlar
| Kayıt | Kural |
|---|---|
| Kayıtlı kart | Saklandığı 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-cards | Her iki modda saklanan kartları birlikte listeler. |
| İşlem, sipariş, abonelik, ödeme linki | Yanı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ı
| Senaryo | Uç / Kontrol |
|---|---|
| Başarılı regular ödeme | regular-payment → 200, result.successful: true. |
| Reddedilen ödeme | 200, 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 ödeme | redirect_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ıt | Var olmayan token ile retrieve-payments → 200, boş payments; refund-payment → 404, Bu işlem bulunamadı. |
Tekrarlanan create-order | Aynı 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 iade | refund-payment amount ile, sonra amount olmadan. |
| Kısmi iadeden sonra iptal | cancel-payment → 422. |
| Webhook imza doğrulama | Değiştirilmiş gövde ile işleyiciniz SignatureException/SignatureError vermelidir. |