Hata Yönetimi
Bu bölüm, API entegrasyonu sırasında karşılaşabileceğiniz hataları ve bunların nasıl yönetileceğini açıklamaktadır.
Hata Yapısı
Tüm API hatalarında standart bir yapı kullanılmaktadır:
json
{
"error": {
"code": "HATA KODU",
"message": "Hata açıklaması"
}
}Hata Kategorileri
1. Request Validasyon Hataları (VPINRE)
Bu hatalar, gönderilen istek parametrelerinin doğrulaması sırasında oluşur:
| Hata Kodu | Açıklama |
|---|---|
| VPINRE-1 | Geçersiz tutar |
| VPINRE-2 | Geçersiz işyeri numarası |
| VPINRE-3 | Geçersiz çalışan numarası |
| VPINRE-4 | Geçersiz telefon |
| VPINRE-5 | Geçersiz kart |
| VPINRE-6 | Kart numarası boş olamaz |
| VPINRE-7 | Kart son kullanma ayı boş olamaz |
| VPINRE-8 | Kart son kullanma yılı 2 haneli (YY) veya 4 haneli (YYYY) formatında olmalıdır |
| VPINRE-9 | Geçersiz CVV |
| VPINRE-10 | Geçersiz taksit |
| VPINRE-11 | Kart numarası 16 hane olmalıdır |
| VPINRE-12 | Kart numarası numerik olmalıdır |
| VPINRE-13 | Kart son kullanma ayı 1-12 arasında olmalıdır |
| VPINRE-14 | Kart son kullanma yılı boş olamaz |
2. Domain Hataları (PAYMENT)
İş mantığı ile ilgili hatalar:
| Hata Kodu | Açıklama |
|---|---|
| PAYMENT-4 | Ödeme bulunamadı |
| PAYMENT-6 | Banka hatası |
| PAYMENT-7 | Bu işlem için yetkiniz yok |
| PAYMENT-9 | Belirtilen externalId ile zaten bir ödeme kaydı bulunmaktadır |
| PAYMENT-10 | Kartınızın süresi dolmuş. Lütfen geçerli bir kart kullanarak devam edin |
| PAYMENT-11 | 'id' ve 'externalId' aynı anda boş olamaz |
| PAYMENT-12 | İstenen işlem bu servis tipi için desteklenmiyor |
| PAYMENT-13 | Bu işlem için henüz ödeme alınmadığından iptal edilemez |
3. Genel Hatalar
| Hata Kodu | Hata | Açıklama |
|---|---|---|
| GENE1 | Beklenmedik bir hata oluştu | Sistem hatası |
4. Banka Hataları
Check status altında dönecek olan hatalar:
| Kod | Açıklama | İç Hata Kodu |
|---|---|---|
| 01 | BANKADAN ONAY ALINIZ | ISSUER_CONFIRM |
| 02 | BANKADAN ONAY ALINIZ (ÖZEL DURUM) | ISSUER_CONFIRM_ERROR |
| 03 | GEÇERSİZ ÜYE İŞYERİ | MERCHANT_NOT_FOUND |
| 04 | KARTA EL KOYUNUZ | PICKUP_CARD |
| 05 | RED | DO_NOT_HONOUR |
| 07 | KARTA EL KOYUNUZ (ÖZEL DURUM) | PICKUP_CARD |
| 08 | ONAY VE KİMLİK DOĞRULA | ISSUER_IDENTITY_ERROR |
| 12 | GEÇERSİZ İŞLEM | INVALID_TRANSACTION |
| 13 | GEÇERSİZ TUTAR | INVALID_AMOUNT |
| 14 | GEÇERSİZ KART NUMARASI | INVALID_CARD_NUMBER |
| 19 | GİRİŞ TEKRAR EDİNİZ | CARD_HOLDER_TRY_AGAIN |
| 21 | İŞLEM YAPILMADI | ISSUER_VALIDATION_ERROR |
| 25 | KAYIT BULUNAMADI | CARD_HOLDER_NOT_FOUND |
| 30 | FORMAT HATASI | ISSUER_VALIDATION_ERROR |
| 34 | SAHTEKARLIKTAN ŞÜPHELENİLİYOR | FRAUD_SUSPECT |
| 36 | KARTA EL KOYUNUZ (Kısıtlı Kart) | RESTRICTED_CARD |
| 38 | PIN DENEMESİ AŞILDI | FRAUD_COUNTER_EXCEEDED |
| 41 | KAYIP KART | LOST_CARD |
| 43 | ÇALINTI KART | STOLEN_CARD |
| 51 | YETERSİZ BAKİYE | NOT_SUFFICIENT_FUNDS |
| 52 | HESAP NUMARASI BULUNAMADI | CARD_HOLDER_NOT_FOUND |
| 53 | HESAP NUMARASI BULUNAMADI | CARD_HOLDER_NOT_FOUND |
| 54 | KARTI SÜRESİ DOLMUŞ | EXPIRED_CARD |
| 55 | HATALI PIN | THREE_D_SECURE_PIN_WRONG |
| 57 | İŞLEME İZİN YOK | NOT_PERMITTED_TO_CARDHOLDER |
| 58 | İŞLEME İZİN YOK (Terminal) | NOT_PERMITTED_TO_TERMINAL / POS_NOT_ALLOWED |
| 59 | SAHTEKARLIK ŞÜPHESİ | FRAUD_SUSPECT |
| 61 | PARA ÇEKME TUTAR LİMİTİ AŞILDI | NOT_PERMITTED_TO_ACTION |
| 62 | YASAKLANMIŞ KART | RESTRICTED_CARD |
| 63 | GÜVENLİK İHLALİ | ISSUER_VALIDATION_ERROR |
| 65 | GÜNLÜK İŞLEM LİMİTİ AŞILDI | NOT_PERMITTED_TO_ACTION |
| 75 | PIN DENEMESİ AŞILDI | FRAUD_COUNTER_EXCEEDED |
| 76 | HENÜZ AKTİF OLMAYAN KART | RESTRICTED_CARD |
| 77 | ORJİNAL İŞLEM VERİLERİ EŞLEŞMİYOR | ISSUER_VALIDATION_ERROR |
| 78 | SİSTEMDE KAYITLI OLMAYAN KART | CARD_HOLDER_NOT_FOUND |
| 82 | GEÇERSİZ CVV | INVALID_CVC2 |
| 83 | PUAN İŞLEMİ ONAY ALMADI | THREE_D_SECURE_PIN_WRONG / ISSUER_VALIDATION_ERROR |
| 85 | RED DEĞİL | SUCCESS_MD_STATUS_0 |
| 86 | PIN KONTROLÜ YAPILAMADI | THREE_D_SECURE_GET_FAILED |
| 88 | KRİPTO HATASI | DSError |
| 89 | KİMLİK DOĞRULAMA BAŞARISIZ | THREE_D_SECURE_INITIALIZE_FAILED |
| 91 | İŞLEM BANKAYA GÖNDERİLEMEDİ | NETWORK_ERROR |
| 92 | İŞLEM BANKAYA GÖNDERİLEMEDİ | NETWORK_ERROR |
| 93 | KART ÜYESİNİN KAYDI YOK | ISSUER_REJECTED |
| 95 | EŞLEŞTİRME HATASI | ISSUER_VALIDATION_ERROR |
| 96 | SİSTEM HATASI | GENERAL_ERROR |
| 98 | 3D DOĞRULAMA BAŞARISIZ | THREE_D_SECURE_INITIALIZE_FAILED |
| 99 | GENEL BANKA HATASI | GENERAL_ERROR |