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

​
نظرة عامة

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

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

تسرد الجدول التالي جميع أسباب فشل المعاملات المحتملة، ومعانيها، وما إذا كانت أخطاء يمكن تصحيحها من قبل المستخدم.
رمز الفشلخطأ المستخدمالوصف
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نعمالرقم السري (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، يكون الرفض بسبب مشكلات على مستوى النظام أو قيود البنك ولا يمكن للعميل حلها.

​
الدعم

للحصول على مساعدة إضافية بشأن فشل المعاملات أو مشكلات التكامل، يرجى الاتصال بفريق الدعم لدينا على support@dodopayments.com.