Hatalar ve Retry
Hata sınıfları, güvenli retry ve operasyonel geri kazanım.
Ödeme API’lerinde “her hatada retry” pahalıya patlar. Önce hata sınıfını ayırın, sonra kullanıcıya ne göstereceğinize karar verin.
Decline ve kod listesi: Testing Declines.
Sınıflar
| Grup | Ne yapmalı? |
|---|---|
| 4xx validation | Payload düzelt; retry yok |
| 401/403 | Key veya permission |
| 409 | Idempotency çakışması; aynı key ile sonucu oku |
| 5xx / timeout | Sınırlı backoff; aynı idempotency key |
Confirm ve decline
Decline sonrası payment çoğunlukla REQUIRES_PAYMENT_METHOD kalır. Yeni payment açmadan önce payments.get ve charge listesine bakın. Hard decline’da aynı kartla döngü yapmayın.
Backoff
const delays = [250, 750, 1500]; // ms, örnekİzleme
- Art arda başarısız confirm oranı
- Webhook teslim başarısızlığı
- Sağlayıcı bazlı decline dağılımı (dashboard)