Skip to main content
Payven Para Transferi modülü; lisanslı ödeme kuruluşları ve büyük platformlar için çoklu banka transfer altyapısı sunar. EFT, FAST ve havale işlemlerini tek API üzerinden çoklu banka konnektörü üzerinden yürütür; toplu işlem desteği, otomatik mutabakat ve transfer iade yönetimi içerir.

​
Temel özellikler

Çoklu Banka Konnektörleri

Kuveyt Türk, Fibabanka, İş Bankası, Akbank, HalkBank ve diğerleri — banka entegrasyonlarının teknik farklarını Payven soyutlar; sizin payload’unuz tüm bankalarda aynıdır.

EFT + FAST + Havale

Tek API ile üç transfer tipi. Bankaya göre otomatik FAST / EFT seçimi.

Bulk İşlem

Onlarca-yüzlerce transferi tek istekte gönderin; banka batch API’leri otomatik kullanılır.

Otomatik Resilience

Geçici hatalarda exponential backoff retry, eşik aşımında devre kesici, token tazeleme — hepsi otomatik.

Webhook + Realtime Dashboard

Transfer durum değişimleri webhook ile teslim edilir; konsol gerçek zamanlı güncellenir.

Tenant İzolasyonu

Her organizasyonun verisi diğer organizasyonlardan tamamen yalıtılmıştır.

​
Base URL

OrtamURL
Sandboxhttps://transfer-sandbox.payven.com.tr
Productionhttps://transfer.payven.com.tr

​
Transfer yaşam döngüsü

DurumAnlam
pendingTransfer oluşturuldu, onay bekliyor (4-eyes principle)
approvedOnaylandı, banka gönderimine hazır
processingBankaya gönderildi, yanıt bekleniyor
completedBanka tarafından onaylandı (senkron başarı)
deliveredBanka kabul etti, hesap geçişi asenkron (FAST modeli)
failedBanka reddetti veya teknik hata
rejectedİç onay sürecinde reddedildi

​
Endpoint kategorileri

KategoriEndpoint örnekleri
Transfer yaşam döngüsüPOST /transfers/bulk/create, /approve, /reject, /send
SorgulamaGET /transfers, GET /transfers/{id}
DekontGET /transfers/{id}/receipt/download, /base-64
HesaplarGET /accounts, /accounts/transactions
AlıcılarPOST /recipients, GET /receiveraccounts
TekrarlayanPOST /recurringtransfers
ValidasyonPOST /validation/iban

​
Hızlı başlangıç

# 1. Bulk transfer oluştur (4-eyes: önce create)
curl -X POST https://transfer-sandbox.payven.com.tr/api/v1/transfers/bulk/create \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Idempotency-Key: payroll-2026-05-01" \
  -H "Content-Type: application/json" \
  -d '{
    "transfers": [
      {
        "external_id":      "PAYROLL-001",
        "amount":           { "amount": 1500000, "currency": "TRY" },
        "transfer_type":    "fast",
        "sender_account_id": "3fa85f64-...",
        "receiver_account": {
          "iban":           "TR000006100000000000000001",
          "owner_name":     "Ahmet Yilmaz",
          "owner_tax_id":   "12345678901"
        },
        "description":      "Mayıs maaş ödemesi"
      }
    ]
  }'

# 2. Onayla (yetkilendirilmiş kullanıcı tarafından)
curl -X POST https://transfer-sandbox.payven.com.tr/api/v1/transfers/bulk/approve \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "transfer_ids": ["8e3f5c12-..."] }'

# 3. Bankaya gönder
curl -X POST https://transfer-sandbox.payven.com.tr/api/v1/transfers/bulk/send \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "transfer_ids": ["8e3f5c12-..."] }'

​
Konnektör kapasitesi

KonnektörEFTFASTHavaleKart TransferiDekont PDFBulk
Kuveyt TürkEvetEvetEvet
Fibabanka————
İş BankasıEvetEvetEvet
AkbankEvetEvetEvet
HalkBankEvet—Evet
Intertech🔧 Yakında🔧 Yakında🔧 Yakında🔧 Yakında——
İstek payload’unuz tüm bankalarda aynıdır. Hangi banka konnektörünün kullanılacağı konsoldan tanımlanan konnektör konfigürasyonuna göre seçilir.

​
Webhook olayları

OlayTetikleyici
transfer.createdYeni transfer oluşturuldu (pending)
transfer.approvedOnaylandı
transfer.rejectedİç onayda reddedildi
transfer.completedBanka senkron onay verdi
transfer.deliveredBanka asenkron kabul etti (FAST)
transfer.failedBanka reddi veya teknik hata
Webhook delivery: HMAC-SHA256 imzalı, 5 retry deneme (1m / 5m / 30m / 2h / 24h, ±%20 jitter), 15sn timeout. Tüm denemeler başarısız olursa olay konsoldan manuel olarak yeniden tetiklenebilir.

​
Sorumlu kullanım

Para transferi modülü iyi yapılandırılmış AML/KYC süreçlerinizle birlikte çalışır. IBAN doğrulama (/validation/iban) ve alıcı doğrulama (recipients master) ile birlikte sahte transfer riskini düşürün.

​
Yol haritası

Para transferi referans dokümanı genişlemeye devam ediyor. Yakında:
  • Transfer Object — tüm alanların referansı
  • Transfer akışları — create/approve/send adımlarının ayrı detay sayfaları
  • Recurring Transfers — periyodik transfer kurulumu
  • Hesap & Alıcı yönetimi — master data yapıları
API referansı için: Para Transferi OpenAPI.