Referans & Yardım
Hata Kodları
Başarısız yanıtlarda errorCode alanı programatik olarak ele alınmalıdır; message alanı kullanıcıya gösterilebilir (Türkçe). HTTP durum kodu genel kategoriyi verir.
API Hata Kodları
| errorCode | HTTP | Anlamı |
|---|---|---|
| VALIDATION_ERROR | 400 | İstek modeli doğrulaması başarısız |
| IDEMPOTENCY_KEY_REQUIRED | 400 | idempotencyKey gönderilmedi |
| AMOUNT_MISMATCH | 400 | amount, products toplamı ile eşleşmiyor |
| INVALID_AMOUNT | 400 | Tutar 0.01–999999.99 aralığı dışında |
| INVALID_REQUEST | 400 | Hatalı istek formatı |
| INVALID_DATE | 400 | Tarih formatı/mantığı hatalı |
| INVALID_STATUS | 400 | Bilinmeyen durum değeri |
| COMPANY_INACTIVE | 400 | Şirket aktif değil |
| NO_ACTIVE_BANK | 400 | Aktif banka entegrasyonu yok |
| BANK_NOT_FOUND | 400 | Belirtilen banka tanımsız |
| BANK_INTEGRATION_REQUIRED | 400 | Banka entegrasyonu gerekli |
| AUTH_ERROR | 401 | Kimlik doğrulama başarısız (anahtar geçersiz/süresi dolmuş) |
| UNAUTHORIZED | 403 | Yetki yok (izin kısıtı) |
| PAYMENT_NOT_FOUND | 404 | Ödeme bulunamadı |
| RATE_LIMIT_EXCEEDED | 429 | İstek limiti aşıldı |
| LINK_GENERATION_ERROR | 500 | Ödeme linki oluşturulamadı |
| INTERNAL_ERROR | 500 | Sunucu hatası |
Banka Ret Kodları
Banka kaynaklı ret durumlarında errorCode banka koduna eşlenir (C10xx). Sık karşılaşılanlar:
| Kod | Anlamı |
|---|---|
| C1000 | Başarılı işlem |
| C1001 | Kart sahibi bankasını aramalı |
| C1004 | Karta el koy / ret |
| C1010 | Kartın süresi dolmuş |
| C1013 | Kart iptal edilmiş |
| C1014 | Kredi kartı limiti yetersiz |
| C1019 | Kart bilgisini kontrol edin |
| C1060 | Taksit hatası |
| C1088 | Geçersiz tutar |
| C1104 | İade işlemi yapılamıyor |
| C1126 / C1127 | Hatalı TCKN / VKN |
Banka ret kodlarının tam listesi ve açıklamaları API yanıtındaki message alanında Türkçe olarak döner. Uçtan uca test için test anahtarınızı kullanın.