Test
Test modu
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ı (order-payment ve subscription-payment akışlarındaki checkout_url) ödemenin geçeceği hesabın sağlayıcısına ait test kartlarını gösterir.
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. |
saved-cards | Her iki modda saklanan kartları birlikte listeler. |
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-payment. |
| 3D süresi dolan ödeme | redirect_url 15 dakika açılmaz → açıldığında callback_url'e successful=0; retrieve-payment 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ı. |
| 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. |