Payven Sanal POS, ödeme kuruluşları ve büyük platformlar için çoklu banka entegrasyonlu bir ödeme alma altyapısıdır. Tek bir API ile birden fazla bankaya ödeme yönlendirir, akıllı yönlendirme motoruyla başarı oranını maksimize eder.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.
Temel özellikler
Çoklu Banka
Tek API ile 12+ banka entegrasyonu. Konnektör ekleme yeni anlaşma değil, konfigürasyon meselesidir.
Akıllı Yönlendirme
BIN, tutar, taksit, kart birliği, banka sağlığı bazlı kompozit-skor ile dinamik yönlendirme.
3D Secure 2.0
Tüm bankalar için tek tip 3DS akışı. Frictionless ve challenge mode ayrımı otomatiktir.
Smart Retry
Geçici banka hatasında işlem alternatif konnektöre yönlendirilir, kullanıcı yeniden ödeme yapmaz.
Hosted Checkout
Payven barındırır, siz yönlendirme URL’si alır. PCI-DSS yükünü minimize eder.
Tek Mutabakat
Tüm bankaların gün sonu hareketleri tek bir mutabakat akışında konsolide edilir.
Base URL
| Ortam | URL |
|---|---|
| Sandbox | https://vpos-sandbox.payven.com.tr |
| Production | https://vpos.payven.com.tr |
Hangi entegrasyonu seçmeliyim?
- Hosted Checkout (önerilir)
- Pay-by-Link
- Direct API
Sizin akış:
- Sunucunuz
POST /checkout/sessionsile bir oturum oluşturur. - Müşteriyi dönen URL’ye yönlendirirsiniz.
- Müşteri kart bilgilerini Payven sayfasında girer.
- Sonuç webhook ile size iletilir.
Endpoint kategorileri
| Kategori | Endpoint örnekleri | Auth |
|---|---|---|
| Ödeme oluşturma | POST /payments, POST /payments/3d/init, POST /checkout/sessions | API Key |
| Ödeme aksiyonları | POST /payments/{id}/refund, /void, /capture | API Key |
| Sorgulama | GET /transactions, GET /payments/{id} | API Key |
| Webhook yönetimi | POST /webhooks | API Key |
| Mutabakat | POST /reconciliations/start | API Key |
| Backoffice | GET /connectors, /connector-configurations | Bearer |
İşlem yaşam döngüsü
Sıradaki adım
Kimlik Doğrulama
Sanal POS’a özgü header’lar ve kurallar.
Payment Objesi
Tüm ödeme yanıtlarında dönen alanların referansı.
İlk Non-3D Ödeme
En basit ödeme akışıyla başlayın.
3D Secure
Müşteri doğrulama akışının tam detayı.