Hata kodları iki kategoriye ayrılır:Documentation Index
Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt
Use this file to discover all available pages before exploring further.
| Kategori | Kaynak | Örnek |
|---|---|---|
| Payven kodları | Payven validasyon, iş kuralı, akış kontrolü | VALIDATION_INVALID_CARD, IDEMPOTENCY_PAYLOAD_MISMATCH |
| Banka kodları | İşlemi gerçekleştiren banka | 00 (başarı), 51 (yetersiz bakiye), 54 (kart süresi dolmuş) |
code ve connector.responseCode alanları hangi kategoriden geldiğini gösterir.
Detay sayfaları
Payven Hata Kodları
Validasyon, idempotency, fraud, routing kodları.
Banka Yanıt Kodları
Bankaların döndürdüğü ISO 8583 standardı kodlar.
Tam liste
Sürekli güncellenen tam liste konsoldaki Hata Kodları ekranındadır: dashboard.payven.com.tr/connector-error-codes Bu ekran, her bankanın özel kod açıklamalarını ve önerilen kullanıcı mesajlarını da içerir.Hata yönetimi prensibi
| Durum | Yapılacak |
|---|---|
VALIDATION_* | İsteği düzeltip yeniden gönderin |
AUTH_* | API anahtarınızı kontrol edin, IP whitelist’i kontrol edin |
RATE_LIMIT_EXCEEDED | Backoff ile yeniden deneyin |
BANK_DECLINED | Müşteriye banka mesajını ileterek başka kart denemesini önerin |
BANK_TIMEOUT | Smart Retry zaten devreye girer; istemci tarafında ek bir şey yapmayın |
5xx | İdempotency-Key ile yeniden deneyin |