Skip to main content
Reçeteler, Payven’i belirli bir iş akışı için entegre etmek isteyen geliştiriciler için baştan sona rehberlerdir. Her reçete; ön koşullar, akış diyagramı, kod örnekleri (Node.js + Python + curl) ve kenar durumlar içerir.

Subscription (Abonelik)

Saved card ile aylık tekrarlayan ödeme — kart bilgisini tek seferde alın, sonraki dönemleri otomatik çekin.

Marketplace Onboarding

Çoklu bayi modelinde yeni bir bayiyi sisteme alma — bayi oluştur, banka profilini bağla, yönlendirme kuralı yaz.

Mutabakat Eşleştirme

Banka EOD dosyasını Payven işlemlerine otomatik eşleştirme + tutarsızlık çözümleme.

4-Eyes Toplu Transfer

İki onaylı toplu para transferi — paket oluştur, onaya gönder, onayla, gönder.

Ortak prensipler

Tüm reçetelerde aşağıdaki kurallar geçerlidir:
Idempotency-Key kullanın — özellikle ödeme, iade, transfer endpoint’lerinde. Bkz. Idempotency.
X-Correlation-Id response header’ını saklayın — destek talebi açarken bu ID ile log zinciri saniyede bulunur.
Webhook kullanın — uzun süreli akışlarda (3DS, mutabakat, manuel inceleme) sonucu polling ile değil webhook ile yakalayın.
Hata yanıtlarını HTTP durum kodu ile değerlendirin — gövdedeki code programatik karar için, detail log için, correlation_id destek için.

Eksik bir reçete mi var?

Sizin senaryonuzu ekleyebiliriz — destek ekibimize yazın. Tipik eklenme süresi 1 hafta.