Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Sandbox ortamı, production ile birebir aynı API’yi sunar — fakat istekler gerçek bankaya gitmez, banka yanıtları simüle edilir.

​
URL

https://vpos-sandbox.payven.com.tr

​
Sandbox anahtarı oluşturma

Konsola sandbox modunda giriş yaparak (sağ üstte ortam değiştirme switch’i) anahtar oluşturun. Sandbox anahtarları pvk-test-... prefix’i ile başlar.

​
Production’dan farklılıklar

ÖzellikProductionSandbox
Gerçek banka isteği✅❌ — simüle edilir
Gerçek 3DS sayfası✅❌ — Payven’in test sayfası
Para hareketi✅❌
Webhook teslimi✅✅ (gerçek HTTP isteği)
Mutabakat✅ — gerçek banka raporu✅ — simüle edilmiş rapor
Rate limitPlan’a göre50 RPS

​
Banka yanıtlarını kontrol etme

Sandbox’ta hangi yanıtın döneceğini kart numarası üzerinden kontrol edebilirsiniz. Her test kartı belirli bir banka yanıtı simüle eder:
SenaryoTest kart numarası
Başarılı Non-3D4546711234567894
Başarılı 3DS5400637000000005
Yetersiz bakiye4111111111111111
3DS başarısız4900200000000007
Banka timeout4242424242424242
Tam liste: Test Kartları.

​
Sandbox geçişi

Sandbox’tan production’a geçerken:
1

Production anahtarı oluşturun

Konsoldan production ortamı seçip yeni anahtar üretin.
2

Base URL'i değiştirin

vpos-sandbox.payven.com.tr → vpos.payven.com.tr.
3

Webhook endpoint'inizi production URL ile kaydedin

Production webhook abonelikleri farklı secret ile gelir — secret manager’ınızı güncelleyin.
4

Production test kartlarını gerçek kartlara çevirin

Test kart numaralarını koddan kaldırın, gerçek kartla bir test ödemesi yapın.
5

Go-Live Checklist'i tamamlayın

Production geçişi kontrol listesi.