الأخطاء

مقدمة

يستخدم التحقق من البطاقة غير الحاضرة رموز استجابة HTTP التقليدية للإشارة إلى نجاح أو فشل طلب API.

كقاعدة عامة:

• تشير الرموز في نطاق 2xx إلى نجاح الطلب.
• تشير الرموز في نطاق 4xx إلى معلمات غير صحيحة أو غير مكتملة (على سبيل المثال، تم إغفال معلمة إلزامية، أو فشلت عملية مع أطراف ثالثة، إلخ).
• تشير الرموز في نطاق 5xx إلى خطأ في خوادم منتج التحقق من البطاقة غير الحاضرة.

كما يُنشئ التحقق من البطاقة غير الحاضرة رسالة خطأ ورمز خطأ بتنسيق JSON:

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

الأخطاء المحتملة

في هذا الموضوع، ستجد الأخطاء المحتملة لنقاط النهاية، مفصولة حسب استجابة HTTP الخاصة بها.

إنشاء المعاملة

رمز HTTP	الرمز	الوصف	السبب
400	40001	error decoding json	البيانات المُرسلة لا تتطابق مع عقد الخدمة.
400	40002	error validating json	بعض المعلومات منسّقة بشكل سيئ أو مفقودة.
400	40021	invalid phone	رقم الهاتف المُقدَّم غير صالح، يجب أن يتبع التنسيق: 55 DDD NUMBER. على سبيل المثال: 5543999999999.
400	40022	invalid email	البريد الإلكتروني المُقدَّم غير صالح.
400	40027	replicated transaction	المعاملة المُرسلة موجودة بالفعل ولا يمكن إنشاؤها مرة أخرى.
400	40045	max value reached	عندما تصل المعاملة إلى قيمة أعلى من الحد المسموح به.
403	40301	not allowed	لا يمتلك المستخدم صلاحية لتنفيذ هذا الإجراء.
404	40404	company not found	الشركة المُقدَّمة غير موجودة.
429	40001	too many requests	تم بلوغ حد المعدل (rate limit).
500	50001	internal error	فشل داخلي في الخدمة.

الحصول على حالة المعاملة

رمز HTTP	الرمز	الوصف	السبب
400	40001	error decoding json	البيانات المُرسلة لا تتطابق مع عقد الخدمة.
400	40002	error validating json	بعض المعلومات منسّقة بشكل سيئ أو مفقودة.
400	40004	transaction id is invalid	معرّف المعاملة غير صالح (من ناحية التنسيق).
400	40301	not allowed	لا يمتلك المستخدم صلاحية لتنفيذ هذا الإجراء.
429	40401	transaction not found	لم يتم العثور على المعاملة.
500	50001	internal error	فشل داخلي في الخدمة.

استرداد مجموعة الإثباتات الخاصة بالمعاملة

رمز HTTP	الرمز	الوصف	السبب
400	40004	transaction id is invalid	معرّف المعاملة غير صالح (من ناحية التنسيق).
400	40009	transaction status is invalid	حالة المعاملة غير صالحة (غير مسموح بها لإنشاء مجموعة الإثباتات).
403	40301	not allowed	لا يمتلك المستخدم صلاحية لتنفيذ هذا الإجراء.
404	40401	transaction not found	لم يتم العثور على المعاملة.
500	50001	internal error	فشل داخلي في الخدمة.

إعادة إرسال إشعار المعاملة

رمز HTTP	الرمز	الوصف	السبب
400	40001	error decoding json	البيانات المُرسلة لا تتطابق مع عقد الخدمة.
400	40002	error validating json	بعض المعلومات منسّقة بشكل غير صحيح أو لم يتم تعبئتها.
400	40004	transaction id is invalid	معرّف المعاملة غير صالح (من ناحية التنسيق).
400	40009	transaction status is invalid	حالة المعاملة لا تسمح بإعادة إرسال الإشعار (تم إكمالها بالفعل).
400	40021	invalid phone	رقم الهاتف المُقدَّم غير صالح، يجب أن يتبع التنسيق: 55 DDD NUMBER. على سبيل المثال: 5543999999999.
400	40022	invalid email	البريد الإلكتروني المُقدَّم غير صالح.
403	40301	not allowed	لا يمتلك المستخدم صلاحية لتنفيذ هذا الإجراء.
404	40401	transaction not found	لم يتم العثور على المعاملة.
429	40001	too many requests	تم بلوغ حد المعدل (rate limit).
500	50001	internal error	تم بلوغ حد المعدل (rate limit).

تأهيل بطاقة الائتمان

رمز HTTP	الرمز	الوصف	السبب
400	40001	error decoding json	البيانات المُرسلة لا تتطابق مع عقد الخدمة.
400	40002	error validating json	بعض المعلومات إما منسّقة بشكل غير صحيح أو مفقودة.
400	40027	replicated transaction	المعاملة المُرسلة موجودة بالفعل ولا يمكن إنشاؤها مرة أخرى.
400	40030	invalid identity	رقم CPF المُقدَّم في الطلب يختلف عن رقم CPF المرتبط بـ processID المحدد.
400	40045	max value reached	عندما تتجاوز المعاملة المبلغ المسموح به.
400	40054	processID is invalid	عندما يكون processID المُقدَّم في الطلب غير صالح (أو غير موجود).
400	40055	processID is expired	عندما يكون processID المُستخدم قديمًا جدًا.
403	40301	not allowed	لا يمتلك المستخدم صلاحية لتنفيذ هذا الإجراء.
404	40404	company not found	الشركة المحددة غير موجودة.
404	40410	processID not found	عندما لا تكون العملية المحددة موجودة.
404	40412	image not found	عندما لا تحتوي العملية المحددة من قِبل المستخدم على صورة.
429	40001	too many requests	تم بلوغ حد المعدل (rate limit).
429	42901	too many requests	عندما يرسل العميل عددًا كبيرًا جدًا من الطلبات، متجاوزًا الحد المحدد مسبقًا.
500	50001	internal error	فشل داخلي في الخدمة.