Test Ortamı
Test ortamı canlı API'nin birebir kopyasıdır: aynı endpoint'ler, aynı istek ve cevaplar, aynı imzalar. Gerçek para hareketi olmaz. Canlıya geçerken yalnızca adres ve anahtarlar değişir.
Test ortamı Base URL:
https://vpos-test.tahsilate.com.tr/external/vpos/v1
https://vpos-test.tahsilate.com.tr/external/vpos/v1
Test anahtarlarınız (apiKey ve secretKey) ve test webhook adresleriniz Profil sayfanızdadır.
Test Kartları
Son kullanma tarihi olarak ileri bir tarih, güvenlik kodu olarak herhangi 3 hane girin.
| Kart numarası | Banka / program | Davranış |
|---|---|---|
| 4355 0843 5508 4358 | Akbank Axess | Bankanın taksit tablosu gelir; sonuç 3D ekranında seçilir. |
| 4546 7112 3456 7894 | Yapı Kredi World | Bankanın taksit tablosu gelir; sonuç 3D ekranında seçilir. |
| 4508 0345 0803 4509 | İş Bankası Maximum | Bankanın taksit tablosu gelir; sonuç 3D ekranında seçilir. |
| 5406 6754 0667 5403 | Garanti BBVA Bonus | Bankanın taksit tablosu gelir; sonuç 3D ekranında seçilir. |
| 4355 0943 5509 4356 | Akbank Axess (banka kartı) | singlePaymentSuggested: true döner, yalnızca tek çekim listelenir; showAllInstallments=true ile tüm taksitler açılır. |
| 5200 1900 0000 0006 | Anlaşmasız banka | Varsayılan taksitler gelir; sonuç 3D ekranında seçilir. |
| 4000 0000 0000 0002 | - | Banka 3D'ye geçmeden reddeder: kartla ödemede HTTP 422, ödeme sayfasında hata mesajı. |
Denenebilecek Senaryolar
- Başarılı ödeme: Bir test kartıyla ödeyin, 3D ekranında "Başarılı Ödeme"yi seçin. Müşteri successUrl'e status=SUCCESSFUL ile döner, webhook gelir, oturum COMPLETED olur.
- 3D'de başarısız: 3D ekranında "Ödeme Başarısız"ı seçin. Müşteri hata mesajıyla ödeme sayfasına döner ve başka kartla deneyebilir; status=FAILED webhook'u gelir, oturum açık kalır.
- Beklemede: 3D ekranında "Ödeme Beklemede"yi seçin. Müşteri successUrl'e status=PENDING ile döner; siparişi beklemede tutun.
- Kart reddi: 4000 0000 0000 0002 ile ödeyin. Banka 3D'ye geçmeden reddeder.
- Banka kartı: 4355 0943 5509 4356 ile taksitleri sorgulayın. Yalnızca tek çekim gelir ve ödeme sayfasında "Taksit seçeneklerini göster" bağlantısı görünür; tıklanınca tüm taksitler açılır.
- Vazgeçme: Ödeme sayfasında "mağazasına dön"e tıklayın. Müşteri failUrl'e status=CANCELLED ile döner.
- Süre dolumu: Oturumu expiresInMinutes: 5 ile açıp bekleyin. Oturum EXPIRED olur, ödeme kabul etmez.
- Deneme sınırı: Aynı oturumda 5 kez ödeme deneyip 3D'de "Ödeme Başarısız"ı seçin veya red kartını kullanın. Oturum FAILED olur, müşteri failUrl'e status=FAILED ile döner.
Canlı Ortamdan Farkları
| Konu | Test ortamında |
|---|---|
| 3D doğrulama | Bankaya gidilmez. Açılan temsili banka sayfasında sonucu (başarılı, beklemede, başarısız) siz seçersiniz. |
| Ödeme sayfası | paymentUrl, ödeme sayfasının test kopyasını açar; üstünde "Test ortamı" etiketi görünür. |
| Webhook | Adresler panel yerine Profil sayfasından tanımlanır; ödeme sayfası oturumundaki callbackUrl'e de gönderilir. Başlıklar, imza ve gövde canlıyla aynıdır. Ulaşılamazsa 10 sn ve 60 sn sonra tekrar denenir (canlıda 24 saat). Adres internetten erişilebilir olmalıdır. |
| İade | Her zaman anında başarılı olur. |
| Dönüş adresleri | http ve localhost kabul edilir; panelde tanımlı alan adı kısıtı uygulanmaz. Canlıda https zorunludur. |
| İstek sınırı | Her API anahtarı için 60 saniyede 60 istek (canlıda varsayılan 60 saniyede 10). Ödeme sayfasındaki IP başına saatlik deneme sınırı test ortamında uygulanmaz. |
Postman Koleksiyonu
Tüm endpoint'leri içeren koleksiyon istekleri kendisi imzalar. İçe aktardıktan sonra bir ortam (environment) oluşturup baseUrl (test ortamı için alan adı, örn. https://vpos-test.tahsilate.com.tr), apiKey ve secretKey değişkenlerini girin.
