Payments Errors


List of Credit Card and Mada Card errors

The following lists each payment error message and provides a description of the error.

The API may also return an error in case the request failed that uses the HTTP status code. Those error descriptions are available on the API Errors section.


INSUFFICIENT FUNDS

There is no enough amount on the card to complete the transaction لا يوجد رصيد كافي في البطاقة

DECLINED

Transaction declined by the customer’s bank. The customer should use an alternate credit card عملية مرفوضة من بنك العميل. يجب استخدام بطاقة أخرى

Allowed time frame for transaction has been expired

The payment process took too long (more than 10 minutes) and then failed. Either because the bank message containing the PIN was delayed to the customer’s mobile phone, or because the customer was late in completing it. عملية الدفع استغرقت وقت أكثر من المسموح (10 دقائق) ففشلت. إما بسبب تأخر وصول رسالة البنك التي تحتوي الرقم السري إلى جوال العميل، أو بسبب تأخر العميل عن إكمالها

UNSPECIFIED FAILURE

The customer’s bank has declined the transaction for an undefined cause. The customer should use an alternate credit card. رفض بنك العميل المعاملة لخطأ غير محدد في نظامهم. يجب المحاولة ببطاقة أخرى

EXPIRED CARD

The transaction failed as the card appears to have expired. البطاقة منتهية

TIMED OUT

The customer’s bank was unable to be connected. The customer should attempt to process this transaction again. فشل الاتصال مع بنك العميل. يجب علي العميل المحاولة مرة أخرى بوقت لاحق

Value ‘xxxx’ is invalid. value: xxxx - reason: Invalid secure code length

The security number (CVC/CVV) was entered incorrectly by the cardholder العميل أدخل رمز الأمان خلف البطاقة (CVC/CVV) بشكل خاطئ

REFERRED

The customer’s bank has indicated there is a problem with the credit card number. بنك العميل رفض العملية بسبب وجود مشكلة في البطاقة وعليه مراجعتهم

3-D Secure transaction attempt failed (AUTHENTICATION_FAILED)

Authentication is unsuccessful or not attempted. The card is either a non-3D card or card issuing bank does not handle it as a 3D transaction المصادقة غير ناجحة أو لم تتم محاولتها. إما بسبب أن البطاقة غير مدرجة في نظام التحقق الأمني 3D Secure، أو أن بنك المصدر لها لا يتعامل معها كذلك

3-D Secure transaction attempt failed (AUTHENTICATION_ATTEMPTED)

Either cardholder or card issuing bank is not 3D enrolled. 3D card authentication is unsuccessful المصادقة فشلت بسبب أن البنك المصدر للبطاقة لم يفعل خدمة التحقق الأمني 3D Secure، أو أن البطاقة غير مدرجة فيها

3-D Secure transaction attempt failed (AUTHENTICATION_NOT_AVAILABLE)

Either cardholder or card issuing bank is not 3D enrolled. 3D card authentication is unsuccessful المصادقة فشلت بسبب أن البنك المصدر للبطاقة لم يفعل خدمة التحقق الأمني 3D Secure، أو أن البطاقة غير مدرجة فيها

3-D Secure transaction attempt failed (Missing parameter)

There was an authentication error خطأ في عملية المصادقة

3-D Secure transaction attempt failed (Relationship not found for merchantID XXX, card type VC)

The merchant account is not configured to receive Visa transactions حساب التاجر لم يفعل من قبل البنك لاستقبال مدفوعات فيزا

3-D Secure transaction attempt failed (Relationship not found for merchantID XXX, card type MC)

The merchant account is not configured to receive MasterCard transactions حساب التاجر لم يفعل من قبل البنك لاستقبال مدفوعات ماستر كارد

3-D Secure transaction attempt failed (CARD_NOT_ENROLLED)

The card was not listed by the issuing bank. The buyer needs to communicate with his bank to activate the card for online payment. Or the card number was entered incorrectly by the cardholder البطاقة غير مدرجة في خدمة التحقق الأمني 3D Secure. أو أن العميل أدخل رقم البطاقة بشكل خاطئ

3-D Secure transaction attempt failed (Value ‘xxx’ is invalid. Cannot determine card brand.)

The card number was entered incorrectly by the cardholder العميل أدخل رقم بطاقة خاطئ

3-D Secure transaction attempt failed (Value ‘xxx’ is invalid. Unable to determine card payment.)

The card number was entered incorrectly by the cardholder العميل أدخل رقم بطاقة خاطئ

3-D Secure transaction attempt failed (Value ‘xxx’ is invalid. Amount exceeds maximum allowed limit)

The amount exceeded the limit per transaction المبلغ تجاوز الحد المسموح لكل عملية

Last Modified : Nov 2019