Çift-yazma stratejisi öneririz. Mevcut gateway’inizi durdurmadan, kademeli olarak trafiğin %1 → %10 → %50 → %100’ünü Payven’e taşıyın. Yönlendirme kuralları ile A/B test yapabilirsiniz.
Kavram eşleştirmesi
API alan eşleştirmesi (POST /payments)
Yanıt eşleştirmesi
Hata yapısı eşleştirmesi
Çoğu Türk gateway hatayı 200 OK + body’destatus: "FAILURE" ile döner. Payven RFC 9457 problem+json kullanır — HTTP status kodunu konuşturur:
Migration sonrası kodunuzu düzeltmeniz gereken yer:
if (res.status === 200) koşulundan if (res.ok) veya if (res.status >= 200 && res.status < 300) koşuluna geçin. Hata yanıtını code alanı üzerinden okuyun, sayısal errorCode üzerinden değil.
Idempotency
Webhook eşleştirmesi
İmza algoritması: bkz. Webhook İmza Doğrulama. HMAC-SHA256, body’i raw imzala, 5 dakika timestamp tolerance.
Geçiş sıralaması (önerilen)
1
Sandbox'ta paralel entegrasyon (1-3 gün)
Mevcut sisteminize dokunmadan, sandbox’ta Payven entegrasyonunu yapın. 3DS dahil tüm akışları test edin.
2
Production canary (1 gün)
Trafiğin %1’ini Payven’e yönlendirin (örn. belirli bir BIN, belirli bir bayi, belirli bir tutar aralığı). Yönlendirme kuralları ile yapılandırın.
3
Hata oranı + latency karşılaştırması (3-7 gün)
Payven
dashboard.payven.com.tr ile mevcut gateway dashboard’ını yan yana izleyin. Hata oranı, p95 latency, başarı oranı.4
Aşamalı geçiş %10 → %50 → %100
Her aşama 2-3 gün izleme — sorun çıkarsa yönlendirme kuralını geri alın.
5
Eski gateway'i pasif et
Mevcut gateway’i kapatmayın — ileride eski işlemlerin iadesi için 13 ay daha açık tutun (chargeback penceresi).
Sık karşılaşılan tuzaklar
Hata kodu eşleştirme tablosu (örnek)
Daha kapsamlı eşleme için Banka Yanıt Kodları ve Payven Hata Kodları.
Yardım
Geçiş sırasında özel bir senaryoda takılırsanız: organizasyon kodunuz + işlemcorrelation_id ile destek ekibimize yazın. Onboarding ekibi tipik olarak 1-2 saat içinde yanıt verir.