Skip to main content
Tekrarlayan transferler (recurring transfers), belirli bir takvim üzerinde otomatik olarak transfer üreten kayıtlardır. Maaş ödemesi, kira, abonelik veya tedarikçi düzenli ödemesi senaryolarında uygulanır.

Akış

Her takvim tetiklemesinde Payven, sizin adınıza yeni bir transfer otomatik oluşturur (POST /transfers/bulk/create muadili). Transferin onay ve gönderim adımları (4-eyes) operatör eylemiyle veya konsol otomasyonuyla yapılır.

Endpoint’ler

Yetki: transfer-admin rolü.

Oluşturma

Schedule yapısı

timezone IANA formatındadır (örn. Europe/Istanbul); takvim hesaplamaları bu zona göre yapılır, gönderim anında UTC’ye normalize edilir.

Yanıt

Pause / Resume

Tekrarlayan transferi geçici olarak durdurmak için:
Pause sonrası is_active: false olur, sonraki tetiklemeler atlanır. Aktif etmek için /resume:

Yetersiz bakiye senaryosu

Tetikleme anında kaynak hesapta yeterli bakiye yoksa transfer failed statüsünde oluşur (error_code: "insufficient_balance"). Tekrarlayan kayıt devam eder — sonraki periyodda yeniden denenir. Operasyonel olarak transfer.failed webhook’una abone olmanız önerilir.

Hata response’ları

Webhook olayları

Tekrarlayan kayıt kendisi olay yayınlamaz; ancak ürettiği her transfer için standart transfer.created / .succeeded / .failed olayları yayınlanır. Webhook payload’unda data.recurring_transfer_id alanı, hangi tekrarlayan kayıttan geldiğini gösterir.