Hata kodları
Başarısız sonuçlardaki sağlayıcıdan bağımsız hata kodları ve müşteriye gösterilebilecek mesaj önerileri.
Beta sürümün dokümanını görüntülüyorsunuz
npm install better-payment@beta. Stabil dokümana geçHer başarısız sonuçta iki hata alanı vardır:
code: birPaymentErrorCode; tüm sağlayıcılarda aynıdır. Kararlarınızı buna göre verin.errorCode: sağlayıcının ham kodu (iyzico10051, PayTRfailed_reason_code, AkbankVPS-xxxx, ...). Loglayın ve sağlayıcı desteğine iletin.
import { PaymentErrorCode, PaymentStatus } from 'better-payment';
const result = await payment.use('iyzico').createPayment(order);
if (result.status === PaymentStatus.FAILURE) {
switch (result.code) {
case PaymentErrorCode.INSUFFICIENT_FUNDS:
case PaymentErrorCode.LIMIT_EXCEEDED:
return askForAnotherCard();
case PaymentErrorCode.INVALID_HASH:
case PaymentErrorCode.FRAUD_SUSPECTED:
return flagForReview(result);
default:
return showGenericError();
}
}code yalnızca başarısız sonuçlarda ve NETWORK_ERROR içeren pending sonuçlarda bulunur; başarılı sonuçlarda yoktur. Henüz eşlenmemiş sağlayıcı kodları UNKNOWN olur ve ham değer errorCode'da kalır.
PaymentErrorCode, better-payment/client'tan da dışa açılır; böylece tarayıcı kodu da ona göre karar verebilir.
Aşağıdaki önerilen mesajlar localizedErrors plugin'inde hazır gelir; plugin bunları müşterinin dilinde errorMessage alanına yazar.
Kodlar
| Kod | Anlamı | Önerilen mesaj (EN) | Önerilen mesaj (TR) |
|---|---|---|---|
INSUFFICIENT_FUNDS | Bakiye ya da kredi limiti yetersiz | Your card has insufficient funds. Try another card. | Kartınızın bakiyesi veya limiti yetersiz. Başka bir kart deneyin. |
CARD_DECLINED | Banka belirli bir sebep belirtmeden reddetti | Your bank declined the payment. Contact your bank or try another card. | Bankanız ödemeyi onaylamadı. Bankanızla görüşün veya başka bir kart deneyin. |
INVALID_CARD | Kart numarası, BIN ya da kartı çıkaran banka geçersiz | Check your card number. | Kart numaranızı kontrol edin. |
EXPIRED_CARD | Süresi dolmuş kart ya da yanlış son kullanma tarihi | Check your card's expiry date. | Kartınızın son kullanma tarihini kontrol edin. |
INVALID_CVC | Yanlış CVC/CVV | Check the security code on the back of your card. | Kartınızın arkasındaki güvenlik kodunu kontrol edin. |
THREEDS_FAILED | 3D Secure doğrulaması başarısız oldu ya da tamamlanmadı | Verification failed. Try again and complete the SMS step. | Doğrulama başarısız oldu. Tekrar deneyin ve SMS adımını tamamlayın. |
FRAUD_SUSPECTED | Dolandırıcılık şüphesi ya da kayıp/çalıntı bildirilmiş kart | We couldn't complete this payment. Contact your bank. | Bu ödeme tamamlanamadı. Bankanızla görüşün. |
LIMIT_EXCEEDED | Tutar ya da işlem sayısı limiti aşıldı | Your card's limit was exceeded. Try another card. | Kartınızın işlem limiti aşıldı. Başka bir kart deneyin. |
DUPLICATE_ORDER | Sipariş numarası daha önce kullanılmış | This order was already submitted. | Bu sipariş zaten gönderildi. |
CANCELLED_BY_CUSTOMER | Müşteri ödeme sayfasından ayrıldı | Payment was cancelled. | Ödeme iptal edildi. |
INVALID_REQUEST | Sağlayıcıya ulaşmadan reddedildi (eksik ya da geçersiz alan) | Something went wrong. Please try again. | Bir sorun oluştu. Lütfen tekrar deneyin. |
NETWORK_ERROR | Sağlayıcıdan yanıt gelmedi; sonuç bilinmiyor (pending) | We're checking your payment. Don't pay again. | Ödemeniz kontrol ediliyor. Lütfen tekrar ödeme yapmayın. |
INVALID_HASH | Callback imzası doğrulanamadı (sahte kabul edin) | Payment could not be verified. | Ödeme doğrulanamadı. |
PROVIDER_ERROR | Sağlayıcı, banka ya da üye işyeri yapılandırması sorunu | Payment is temporarily unavailable. Please try again later. | Ödeme geçici olarak yapılamıyor. Lütfen daha sonra tekrar deneyin. |
UNKNOWN | Henüz eşlenmemiş; errorCode'a bakın | Payment failed. Please try again or use another card. | Ödeme başarısız oldu. Tekrar deneyin veya başka bir kart kullanın. |
INVALID_HASH ya da FRAUD_SUSPECTED ayrıntılarını asla müşteriye göstermeyin. INVALID_REQUEST için isteği kendi tarafınızda düzeltin; hata mesajı alanın adını verir. NETWORK_ERROR için müşterinin tekrar denemesine izin vermeden önce ödemeyi getPayment() ile kontrol edin.
Neler eşleniyor
| Sağlayıcı | code'un kaynağı |
|---|---|
| iyzico | Ödeme hata kodları (10005, 10051, 10054, 10084, 102xx, ...). Tablo IYZICO_ERROR_CODES olarak dışa açılır. |
| PayTR | failed_reason_code 1–3, 6, 8–11 ve 99. 0 kodunun sebebi serbest metindir ve UNKNOWN kalır. Tablo PAYTR_ERROR_CODES olarak dışa açılır. |
| Akbank | Bankanın ISO 8583 hostResponseCode'u (51, 05, 54, ...); ISO8583_ERROR_CODES olarak dışa açılır. VPS-xxxx kodu errorCode'da kalır. |
| Parampos | Param döndürdüğünde bankanın Banka_Sonuc_Kod alanındaki ISO 8583 kodu (51, 05, 54, ...), yoksa Param'ın negatif Sonuc kodları (-105, -119, -2xx, ...). Sonuc tablosu PARAMPOS_ERROR_CODES olarak dışa açılır. Sonuc errorCode'da kalır. |
Tüm sağlayıcılar Better Payment'in kendi atadığı kodları da kullanır: NETWORK_ERROR, INVALID_HASH, 3D Secure hataları (MD_STATUS_x) ve istek doğrulama (VALIDATION_ERROR → INVALID_REQUEST).
Eksik bir kod mu var? Sağlayıcıyı, ham errorCode'u ve mesajını yazarak bir issue açın.