Skip to main content
Sandbox ortamı, production ile birebir aynı API’yi sunar — gerçek para hareketi yapılmaz. Banka çağrıları organizasyonunuzun sandbox konnektör konfigürasyonuna göre ya simüle edilir ya da bankanın test ortamına yönlendirilir.

​
URL

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

​
Sandbox kimlik bilgileri

Konsolu sandbox modunda açıp Ayarlar → API Anahtarları ekranından client_id + client_secret çifti üretin. Sandbox client ID’leri pvk_test_... prefix’i ile başlar; production’dan ayrıdır. Identity’den access token alma akışı Kimlik Doğrulama sayfasında. Sandbox token endpoint’i: 
https://identity-sandbox.payven.com.tr/api/v1/auth/{slug}/token

​
Production’dan farklılıklar

ÖzellikProductionSandbox
Para hareketi
Webhook teslimi(gerçek HTTP isteği)
Mutabakat— gerçek banka raporu— simüle veya banka test raporu
Rate limitPlan’a göre50 RPS

​
Banka çağrı modu

Sandbox’ta banka çağrısı, organizasyonunuzun konnektör konfigürasyonuna göre iki şekilde yapılabilir:
KonfigürasyonDavranış
Mock konnektörBanka tarafına hiç çağrı atılmaz. Yanıt Payven tarafında simüle edilir; entegrasyon testleri ve CI için idealdir.
Banka test ortamı konnektörüBankanın resmi test ortamına gerçek HTTP çağrısı yapılır. Banka tarafı simülasyon kurallarıyla çalışır (tipik test kartları, 3DS test sayfası, vb.). Banka entegrasyonunun uçtan uca doğrulanması için kullanın.
Hangi modun aktif olduğunu konsol → Konnektör Konfigürasyonları ekranından görebilirsiniz. Yeni bir konfigürasyon eklerken modu seçersiniz.

​
Test kart numaraları

Test kart numaraları bankanın test ortamı tarafından belirlenir. Konsoldaki Test Kartları ekranında, organizasyonunuzun aktif sandbox konfigürasyonlarına göre derlenmiş güncel matris yer alır: → Konsol → Test Kartları Bu ekran her banka için: başarılı işlem kartları, ret senaryoları (yetersiz bakiye, kart bloke), 3DS challenge/frictionless test kartları ve geçerli son kullanma tarihi / CVV bilgilerini içerir.

​
Sandbox → production geçişi

1

Production credentials

Konsoldan production ortamı seçip yeni client_id + client_secret üretin (pvk_live_...).
2

Base URL'leri değiştirin

Identity: identity-sandbox.payven.com.tr → identity.payven.com.tr
Sanal POS: vpos-sandbox.payven.com.tr → vpos.payven.com.tr
3

Webhook abonelikleri

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

Test kartları kaldırın

Test kart numaralarını koddan kaldırın, ilk production işleminizi gerçek kartla yapın.
5

Go-Live Checklist

Production geçişi kontrol listesi — IP whitelist, secret yönetimi, rate limit, izleme.