نظرة عامة على الواجهة
يتوفر حاليًا كل من
/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؛ بل تحصل فقط على الإسقاط العام الأدنى.