نظرة عامة على الواجهة
يعمل كل من
/orders/{id} و/orders/{id}/ حاليًا. يُعد معرّف الطلب جزءًا من رابط الدفع، ويجب اعتباره معرّفًا حساسًا ومعتمًا، ولا تنشره علنًا.
الاستعلام المجهول
يمكن لصفحة الدفع القراءة مباشرةً عند فقدان حالة تسجيل الدخول:id وdescription وprice وstate وpay_way وpay_url وexpired_at وcreated_at. وهي لا تعيد الحساب أو Application أو Package أو معرّفات الدفع الداخلية أو metadata.
الاستعلام المصادق عليه
application / applications وpackage / packages وbank_details وinvoice_automation وحقول النموذج. إذا كان المستخدم مصادقًا عليه لكنه ليس مالك الطلب، فسيُعاد 403؛ باستثناء المشرفين الفائقين.
الحقول الرئيسية
قد تضيف الاستجابة الكاملة حقولًا وفقًا لطريقة الدفع، وينبغي للعميل قراءتها حسب الحاجة، وتجنب دائمًا تسجيل metadata الحساسة في الاستجابة الكاملة.
معالجة الأخطاء
404: معرّف الطلب غير موجود.403: تم تسجيل الدخول لكن المستخدم ليس مالك الطلب.- لا تعيد الطلبات المجهولة
401؛ بل تحصل فقط على الإسقاط العام الأدنى.
إلغاء الفاتورة باللون الأحمر وإعادة الطلب
يمكن قراءة الفاتورة الحالية للطلب عبرGET /api/v1/orders/{order_id}/invoice/. بعد تقديم الإلغاء التلقائي باللون الأحمر، تظل الفاتورة Issued، ويشير red_state إلى تقدم الإلغاء باللون الأحمر؛ نجاح التقديم لا يعني اكتمال الإلغاء باللون الأحمر. أثناء انتظار التأكيد، أو إصدار فاتورة حمراء، أو الأرشفة، لا يمكن للطلب إعادة طلب فاتورة.
عندما يطلب المسؤول إلغاءً باللون الأحمر بسبب خطأ في معلومات الفوترة مثل الاسم أو الرقم الضريبي، يكون سبب الإلغاء باللون الأحمر هو “خطأ في الفوترة”؛ بينما يستمر الإلغاء التلقائي باللون الأحمر الناتج عن استرداد الطلب في استخدام “إنهاء الخدمة”.
بعد إصدار الفاتورة الحمراء وأرشفتها بنجاح، تصبح الفاتورة الأصلية Voided، وعندها فقط يمكن للطلب إعادة التقديم. يمكن عرض الفاتورة الأصلية في سجل الفواتير. عند فشل الإلغاء باللون الأحمر أو عندما تكون النتيجة قيد التحقق، يتولى القسم المالي المراجعة، ولن يُرفع قيد الفوترة عن الطلب مبكرًا. يجب أولًا إلغاء الفواتير الصادرة يدويًا أو إلغاؤها باللون الأحمر في النظام الضريبي أو نظام الفوترة، ثم يؤكد القسم المالي ذلك على المنصة.

