Para Transferi

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

Ortam	URL
Sandbox	`https://transfer-sandbox.payven.com.tr`
Production	`https://transfer.payven.com.tr`

Transfer yaşam döngüsü

Durum	Anlam
`pending`	Transfer oluşturuldu, onay bekliyor (4-eyes principle)
`approved`	Onaylandı, banka gönderimine hazır
`processing`	Bankaya gönderildi, yanıt bekleniyor
`completed`	Banka tarafından onaylandı (senkron başarı)
`delivered`	Banka kabul etti, hesap geçişi asenkron (FAST modeli)
`failed`	Banka reddetti veya teknik hata
`rejected`	İç onay sürecinde reddedildi

Endpoint kategorileri

Kategori	Endpoint örnekleri
Transfer yaşam döngüsü	`POST /transfers/bulk/create`, `/approve`, `/reject`, `/send`
Sorgulama	`GET /transfers`, `GET /transfers/{id}`
Dekont	`GET /transfers/{id}/receipt/download`, `/base-64`
Hesaplar	`GET /accounts`, `/accounts/transactions`
Alıcılar	`POST /recipients`, `GET /receiveraccounts`
Tekrarlayan	`POST /recurringtransfers`
Validasyon	`POST /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ör	EFT	FAST	Havale	Kart Transferi	Dekont PDF	Bulk
Kuveyt Türk		Evet		Evet		Evet
Fibabanka	—	—	—		—
İş Bankası		Evet		Evet		Evet
Akbank		Evet		Evet		Evet
HalkBank		Evet		—		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ı

Olay	Tetikleyici
`transfer.created`	Yeni transfer oluşturuldu (pending)
`transfer.approved`	Onaylandı
`transfer.rejected`	İç onayda reddedildi
`transfer.completed`	Banka senkron onay verdi
`transfer.delivered`	Banka asenkron kabul etti (FAST)
`transfer.failed`	Banka 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.

Genel Bakış

Transfer Akışı (4-Eyes)

Tekrarlayan Transferler

Sorgulamalar & Dekont

Alıcılar

Validasyon

Raporlama & İzleme

Webhook'lar

Hata Kodları

Temel özellikler

Çoklu Banka Konnektörleri

EFT + FAST + Havale

Bulk İşlem

Otomatik Resilience

Webhook + Realtime Dashboard

Tenant İzolasyonu

Base URL

Transfer yaşam döngüsü

Endpoint kategorileri

Hızlı başlangıç

Konnektör kapasitesi

Webhook olayları

Sorumlu kullanım

Yol haritası

​Temel özellikler

Çoklu Banka Konnektörleri

EFT + FAST + Havale

Bulk İşlem

Otomatik Resilience

Webhook + Realtime Dashboard

Tenant İzolasyonu

​Base URL

​Transfer yaşam döngüsü

​Endpoint kategorileri

​Hızlı başlangıç

​Konnektör kapasitesi

​Webhook olayları

​Sorumlu kullanım

​Yol haritası

Temel özellikler

Base URL

Transfer yaşam döngüsü

Endpoint kategorileri

Hızlı başlangıç

Konnektör kapasitesi

Webhook olayları

Sorumlu kullanım

Yol haritası