Skip to main content
Payven, Türkiye’nin finansal teknoloji altyapısıdır. Türkiye’nin önde gelen bankalarıyla entegre tek bir API üzerinden sanal POS, para transferi, fraud yönetimi ve mutabakat modüllerini kullanırsınız. Lisanslı ödeme kuruluşları ve büyük platformlar; banka entegrasyonlarının teknik karmaşıklığını Payven’e bırakır, kendi ürünlerine odaklanır. Fatura ödeme ve açık bankacılık modülleri geliştirme aşamasındadır.

5 dakikada ilk ödeme

Token al, ödeme oluştur, sonucu webhook ile yakala. Kopyala-yapıştır curl ile çalışır örnekler.

API Referansı

Tüm endpoint’ler, parametre şemaları ve deneme paneli ile tarayıcıdan sandbox üzerinden deneme.

Mimari

Servis topolojisi, organizasyon & merchant modeli, ortam URL’leri — 5 dakikada ekosistem.

Hesap Yapısı

Organizasyon, merchant ve API anahtarı arasındaki ilişki — onboarding’den önce 5 dakika.

​
API’a ilk bakış

Sanal POS üzerinde tek isteklik bir Non-3D ödeme örneği. İstek; OAuth 2.0 Bearer token ile yetkilendirilir, kart bilgisi JSON request body’sinde iletilir, akıllı yönlendirme motoru uygun konnektörü seçer ve banka onayını eş zamanlı döndürür. 
curl https://vpos.payven.com.tr/api/v1/payments \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "ORDER-1001",
    "amount":      { "amount": 15000, "currency": "TRY" },
    "installment": 1,
    "card": {
      "holder_name":  "Test Kullanici",
      "number":       "4546711234567894",
      "expire_month": "12",
      "expire_year":  "2030",
      "cvv":          "000"
    }
  }'
Tutarlar kuruş cinsindendir (15000 = 150,00 ₺). Başarılı yanıt 200 OK döner; gövdede Payven transaction_id ile banka yanıt detayları yer alır. Token alımı, 3D Secure akışı ve webhook doğrulaması için: Hızlı Başlangıç.

​
Ürün ailesi

Sanal POS

Akıllı yönlendirme, 3D Secure 2.x, ön provizyon, hosted checkout, pay-by-link, taksit kampanyaları, recurring, DCC, puan sorgulama.

Para Transferi

EFT, FAST, havale ve banka hesabı transferi. Çoklu banka konnektörü, otomatik retry ve devre kesici, otomatik mutabakat.

Identity & Auth

OAuth 2.0 Client Credentials, multi-tenant kimlik yönetimi, API anahtar rotasyonu, BIN / banka / MCC sorgu servisleri.

Mutabakat

Banka dosyalarının otomatik çözümlenmesi, eşleştirme, tutarsızlık yönetimi, settlement raporları.
Sanal POS akışları içinde gerçek zamanlı fraud kontrolü otomatik çalışır — hız kontrolü, blacklist/whitelist, BIN kısıtlama, manuel inceleme kuyruğu. Kurallar konsoldan yönetilir, fraud_blocked veya fraud_review_required hata kodları ile yanıtlanır.

​
Entegrasyon adımları

1

Organizasyon hesabınızı açın

Konsola erişim için satış ekibimizle iletişime geçin. Onboarding 1-2 iş günü sürer.
2

API anahtarınızı oluşturun

Konsoldan client_id ve client_secret çifti üretin. Secret yalnızca oluşturma anında gösterilir, güvenli bir vault’ta saklayın.
3

Sandbox'ta token alın

Identity’den OAuth 2.0 client_credentials akışıyla access token alın. Kod örnekleri (Node, Python, C#, Go, PHP) auto-refresh dahil hazır.
4

İlk ödemeyi gerçekleştirin

Hızlı Başlangıç — curl ile çalışan örneklerle 3DS akışını test edin.
5

Webhook ile asenkron yakalayın

HTTPS endpoint’inizi kaydedin, HMAC-SHA256 imzasını doğrulayın.
6

Production'a geçin

Go-live kontrol listesi — IP whitelist, secret yönetimi, rate limit, izleme.

​
Payven’i farklı kılan ne?

Tek Kimlik, Tüm Ürünler

Tek bir access token planınızdaki bütün modüllere geçer. Sanal POS, para transferi, fraud — hepsi aynı bearer token ile çağrılır, ayrı kimlik akışı yok.

Akıllı Yönlendirme + Smart Retry

Bileşik skor motoru; BIN, tutar, taksit, kart birliği ve banka sağlığını dikkate alarak yönlendirir. Banka arızasında işlem otomatik olarak alternatif konnektöre düşer.

Standartlara uyumlu API

HTTP semantiğine sıkı uyum: doğru status kodları, RFC 9457 application/problem+json hata yanıt formatı, Idempotency-Key desteği, sayfalı listelemeler, tutarlı snake_case alan adları.

Operasyonel Şeffaflık

Konsolda her API çağrısının korelasyon zinciri, banka yanıt detayı, retry geçmişi ve webhook teslim logu — debug saatleri değil dakikaları alır.

​
Hedef kitle

Payven, son tüketiciye veya bireysel satıcılara doğrudan hizmet vermez. Müşterilerimiz Türkiye’de lisanslı veya yüksek hacimli kurumsal yapılardır:
  • TCMB lisanslı ödeme ve elektronik para kuruluşları — alt bayilerine ödeme hizmeti sunan
  • Bankalar — sanal POS gateway altyapısını modernize eden
  • Büyük e-ticaret platformları ve marketplace’ler — birden fazla bankayı tek API’den yöneten
  • Yüksek hacimli fintech’ler — orchestration katmanı arayan
Bireysel geliştiriciler veya küçük ölçekli e-ticaret siteleri için doğrudan bir PSP ile çalışmak daha uygundur.

​
Yol haritası

Aşağıdaki modüller geliştirme aşamasındadır; canlı API’ye dahil değildir. Erken erişim için satış ekibimizle iletişime geçin.
  • Fatura Ödeme — Kurum, GSM ve fatura tahsilat entegrasyonları.
  • Açık Bankacılık — Hesap bilgisi (AIS) ve ödeme başlatma (PIS) servisleri.
Yenilikler ve sürüm notları için: Changelog.

​
Yardım

API Referansı

Sandbox üzerinde Deneme paneli özellikli interaktif endpoint’ler.

Konsol

İşlem izleme, raporlama, anahtar yönetimi.

Destek

Teknik destek ve onboarding.