Temel özellikler
Çoklu Banka
Türkiye’nin önde gelen bankalarıyla tek API üzerinden entegrasyon. Yeni konnektör eklemek anlaşma değil, konfigürasyon meselesidir.
Akıllı Yönlendirme
BIN, tutar, taksit, kart birliği ve banka sağlığını dikkate alan bileşik skor motoru ile dinamik yönlendirme.
3D Secure 2.x
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
Kart girişi Payven’in barındırdığı sayfada yapılır; siz sadece yönlendirme URL’si alırsınız. 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
Tüm path’ler/api/v1/ ön ekiyle başlar. Tam liste için: API Referansı.
| Kategori | Endpoint örnekleri | Auth |
|---|---|---|
| Ödeme oluşturma | POST /payments, POST /payments/3d/init, POST /payments/order-link, POST /checkout/sessions | Bearer |
| Ödeme aksiyonları | POST /payments/{id}/refund, /void, /capture, /3d/complete, /dcc/confirm, /point-inquiry | Bearer |
| Sorgulama | GET /payments/{id}, GET /payments/{id}/query, GET /payments/{id}/history, GET /transactions, GET /transactions/export | Bearer |
| Tekrarlayan ödeme | POST /recurring, GET /recurring, POST /recurring/{id}/cancel, POST /recurring/{id}/installments/{idx}/cancel | Bearer |
| İade listesi | GET /refunds, GET /refunds/{id} | Bearer |
| Settlement | GET /settlements, POST /settlements, GET /settlements/export | Bearer |
| Chargeback | GET /chargebacks, POST /chargebacks, PUT /chargebacks/{id}/status | Bearer |
| Mutabakat | POST /reconciliations/start, POST /reconciliations/{id}/finalize | Bearer |
| Saved Cards | GET /cards, DELETE /cards/{id} | Bearer |
| BIN sorgu | POST /bins/check, GET /bins/{bin} | Bearer |
| Yönlendirme kuralları | GET/POST/PUT /routing-rules, POST /routing-rules/resolve | Bearer |
| Konnektör | GET/POST /connectors, GET /connector-configurations, GET /connectors/{id}/health | Bearer |
| Webhook yönetimi | POST /webhook-subscriptions, POST /webhook-subscriptions/{id}/rotate-secret, GET /webhook-subscriptions/{id}/deliveries | Bearer |
| İptal Talepleri | /cancellation-requests (4-eyes void onayı) | Bearer |
İşlem yaşam döngüsü
Yukarıdaki diyagram konsumer-friendly semantik durumları gösterir. Wire üzerinde
(API yanıtları, webhook payload’ları)
Tam enum tablosu: Payment Objesi → Status.
status alanı TransactionStatus enum’unun
snake_case değerleridir. Eşleştirme:| Diyagramdaki durum | Wire status |
|---|---|
| Created | created |
| Pending3D | three_d_secure_init_processing |
| Authenticated | three_d_secure_auth_processing |
| Authorized | authorized |
| Captured / Settled | completed (settlement durumu ayrı Settlement kaynağında izlenir) |
| Refunded | refunded |
| PartiallyRefunded | Üst Transaction completed kalır; iade alt-kaydı refunded (geçici: refund_processing) |
| Voided | canceled (geçici: canceled_processing) |
| Failed | failed |
| (Geçici işlem) | processing, capture_processing |
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ı.