TahsilatE Logo
Geliştirici Ortamı

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

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 / programDavranış
4355 0843 5508 4358Akbank AxessBankanın taksit tablosu gelir; sonuç 3D ekranında seçilir.
4546 7112 3456 7894Yapı Kredi WorldBankanın taksit tablosu gelir; sonuç 3D ekranında seçilir.
4508 0345 0803 4509İş Bankası MaximumBankanın taksit tablosu gelir; sonuç 3D ekranında seçilir.
5406 6754 0667 5403Garanti BBVA BonusBankanın taksit tablosu gelir; sonuç 3D ekranında seçilir.
4355 0943 5509 4356Akbank Axess (banka kartı)singlePaymentSuggested: true döner, yalnızca tek çekim listelenir; showAllInstallments=true ile tüm taksitler açılır.
5200 1900 0000 0006Anlaşmasız bankaVarsayı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ı

KonuTest ortamında
3D doğrulamaBankaya 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.
WebhookAdresler 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.
İadeHer zaman anında başarılı olur.
Dönüş adreslerihttp 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.

Koleksiyonu indir