Sanal POS

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.

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/sessions ile 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.

Avantajlar: En düşük PCI-DSS yükü (SAQ-A), banka sayfası gibi görünür, 3DS otomatik.Uygunsa: Çoğu B2C entegrasyonu için tercih bu olmalı.Detay →

Sizin akış:

Sunucunuz POST /payments/order-link ile link üretir.
SMS, e-posta veya WhatsApp ile müşteriye gönderirsiniz.
Müşteri linkten ödemeyi yapar.

Avantajlar: Sıfır frontend geliştirme, çağrı merkezi senaryoları için ideal.Detay →

Sizin akış:

Kart bilgilerini kendi formunuzdan toplarsınız.
POST /payments ile Payven’e iletirsiniz.
3DS gerekiyorsa müşteriyi yönlendirme URL’sine yönlendirirsiniz.
Callback ile dönüş alırsınız.

Avantajlar: UI üzerinde tam kontrol.Maliyet: PCI-DSS denetim kapsamı yüksek (SAQ-D veya ROC). Yalnızca sertifikalı organizasyonlar kullanmalı.Non-3D → · 3D Secure →

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ı) 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`

Tam enum tablosu: Payment Objesi → Status.

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ı.

Genel Bakış

Ödeme Akışları

Sorgulamalar

Akıllı Yönlendirme

Mutabakat

Webhook'lar

Raporlama & İzleme

Test

Hata Kodları

Temel özellikler

Çoklu Banka

Akıllı Yönlendirme

3D Secure 2.x

Smart Retry

Hosted Checkout

Tek Mutabakat

Base URL

Hangi entegrasyonu seçmeliyim?

Endpoint kategorileri

İşlem yaşam döngüsü

Sıradaki adım

Kimlik Doğrulama

Payment Objesi

İlk Non-3D Ödeme

3D Secure

​Temel özellikler

Çoklu Banka

Akıllı Yönlendirme

3D Secure 2.x

Smart Retry

Hosted Checkout

Tek Mutabakat

​Base URL

​Hangi entegrasyonu seçmeliyim?

​Endpoint kategorileri

​İşlem yaşam döngüsü

​Sıradaki adım

Kimlik Doğrulama

Payment Objesi

İlk Non-3D Ödeme

3D Secure

Temel özellikler

Base URL

Hangi entegrasyonu seçmeliyim?

Endpoint kategorileri

İşlem yaşam döngüsü

Sıradaki adım