الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

توفر واجهة برمجة تطبيقات مدفوعات دودي أسباب فشل المعاملات بالتفصيل لمساعدتك على فهم سبب عدم نجاح محاولة الدفع. هذه الأسباب موحدة عبر طرق الدفع ومقدمي الخدمات المختلفة، مما يسهل تنفيذ معالجة الأخطاء بشكل متسق في تطبيقك. يتضمن كل رد فشل معاملة:
  • رمز سبب الفشل المحدد
  • رسالة خطأ قابلة للقراءة البشرية
  • سياق إضافي حول الفشل عند توفره
  • ما إذا كان الخطأ يمكن تصحيحه من قبل المستخدم أو يتطلب تدخل النظام
فهم هذه الأسباب أمر بالغ الأهمية لـ:
  • تقديم ملاحظات واضحة لعملائك
  • تنفيذ منطق إعادة المحاولة المناسب
  • التعامل مع سيناريوهات الفشل المختلفة بشكل سلس
  • الحفاظ على نظام معالجة مدفوعات موثوق

​
أسباب فشل المعاملات

تسرد الجدول التالي جميع أسباب فشل المعاملات المحتملة، ومعانيها، وما إذا كانت أخطاء يمكن تصحيحها من قبل المستخدم.
رمز الفشلخطأ المستخدمالوصف
AUTHENTICATION_FAILUREنعمفشلت عملية المصادقة أثناء المعاملة
AUTHENTICATION_REQUIREDنعمتحتاج المعاملة إلى مصادقة إضافية لإكمالها
AUTHENTICATION_TIMEOUTنعمانتهت مهلة عملية المصادقة
CARD_DECLINEDلاتم رفض البطاقة من قبل البنك المصدر
CARD_NOT_ACTIVATEDنعملم يتم تفعيل البطاقة من قبل حامل البطاقة
CARD_VELOCITY_EXCEEDEDنعمتم محاولة إجراء العديد من المعاملات في فترة قصيرة
CUSTOMER_CANCELLEDنعمقام العميل بإلغاء المعاملة
DO_NOT_HONORلاتم رفض المعاملة من قبل البنك المصدر
EXPIRED_CARDنعمانتهت صلاحية البطاقة
FRAUDULENTنعمتم تصنيف المعاملة على أنها قد تكون احتيالية
GENERIC_DECLINEلاتم رفض المعاملة لسبب غير محدد
INCORRECT_CVCنعمكان رمز CVC المقدم غير صحيح
INCORRECT_NUMBERنعمتم إدخال رقم البطاقة بشكل غير صحيح
INSUFFICIENT_FUNDSنعمالحساب لا يحتوي على أموال كافية لإكمال المعاملة
INVALID_ACCOUNTنعمتفاصيل الحساب المقدمة غير صحيحة
INVALID_AMOUNTنعممبلغ المعاملة غير صحيح
INVALID_CARD_NUMBERنعمتنسيق رقم البطاقة غير صحيح
INVALID_CARD_OWNERنعممعلومات مالك البطاقة غير صحيحة
INVALID_CVCنعمتنسيق CVC غير صحيح
INVALID_EXPIRY_YEARنعمسنة انتهاء صلاحية البطاقة غير صحيحة
INVALID_PINنعمالرقم السري المقدم غير صحيح
INVALID_REQUESTنعمتحتوي طلب المعاملة على بيانات غير صحيحة
INVALID_UPI_IDنعممعرف UPI المقدم غير صحيح
LIMIT_EXCEEDEDنعمتتجاوز المعاملة حد البطاقة أو الحساب
LIVE_MODE_TEST_CARDنعمتم استخدام بطاقة اختبار في وضع مباشر
LOST_CARDنعمتم الإبلاغ عن البطاقة على أنها مفقودة
MANDATE_INVALIDنعمالتفويض للدفع غير صالح
MANDATE_REQUIREDنعميتطلب هذا المعاملة تفويضًا
MANDATE_REQUIRED_SYSTEMلايتطلب النظام تفويضًا لهذا النوع من المعاملات
NETWORK_ERRORلاحدث خطأ في الشبكة أثناء المعاملة
NETWORK_TIMEOUTلاانتهت مهلة طلب الشبكة
ORDER_CREATION_FAILEDلافشل إنشاء الطلب للمعاملة
PAYMENT_METHOD_PROVIDER_DECLINEDنعمرفض مزود طريقة الدفع المعاملة
PAYMENT_METHOD_UNSUPPORTEDنعمطريقة الدفع غير مدعومة لهذه المعاملة
PICKUP_CARDنعمتم الإبلاغ عن البطاقة على أنها مسروقة ويجب استردادها
PROCESSING_ERRORلاحدث خطأ أثناء معالجة المعاملة
PROVIDER_UNSUPPORTEDلالا يدعم مزود الدفع هذا النوع من المعاملات
REENTER_TRANSACTIONنعمتحتاج المعاملة إلى إعادة إدخالها
REVOCATION_OF_AUTHORIZATIONنعمتم إلغاء التفويض للمعاملة
STOLEN_CARDنعمتم الإبلاغ عن البطاقة على أنها مسروقة
TRANSACTION_NOT_ALLOWEDنعمالمعاملة غير مسموح بها لهذه البطاقة أو الحساب
TRANSACTION_NOT_APPROVEDنعملم تتم الموافقة على المعاملة
TRY_AGAIN_LATERلايجب إعادة محاولة المعاملة لاحقًا
UNKNOWN_ERRORلاحدث خطأ غير معروف
خطأ المستخدم يشير إلى ما إذا كان يمكن حل رفض الدفع من قبل العميل. عندما يكون true، يمكن للعميل اتخاذ إجراء لإصلاح المشكلة (مثل إدخال تفاصيل البطاقة الصحيحة). عندما يكون false، يكون الرفض بسبب مشكلات على مستوى النظام أو قيود مصرفية لا يمكن حلها من قبل العميل.

​
الدعم

للحصول على مساعدة إضافية بشأن فشل المعاملات أو مشكلات التكامل، يرجى الاتصال بفريق الدعم لدينا على [email protected].