POST/api/public/access-request/paypal/capture-order

يلتقط (يُكمل نهائيًا) طلبًا أُنشئ مسبقًا ووافق عليه المشتري في عملية دفع PayPal. الخادم هو المرجع — لا يمكن للعميل التأثير على أي مبلغ.

المصادقة والأمان

لا يلزم أي مصادقة

strictLimiter (10 Req/15min، مرتبط بعنوان IP).

متطابق القوة: لا

المعلمات

order_id(body, string، إلزامي)— مُعرّف طلب PayPal الذي تُعيده paypal/create-order

مثال طلب

{"order_id":"<PAYPAL_ORDER_ID>"}

مثال استجابة

{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}

رموز الأخطاء

400 ORDER_ID_REQUIRED — order_id مفقود.
404 UNKNOWN_ORDER — order_id ليس طلبًا معروفًا تم إنشاؤه مسبقًا.
409 CAPTURE_NOT_COMPLETED — لم يوافق المشتري على الدفع بعد.
502 PAYPAL_CAPTURE_FAILED — خطأ في الاتصال مع PayPal.

إثبات الاختبار المباشر

تم التحقق مباشرة من كلتا الحالتين السلبيتين دون إعداد PayPal (400 ORDER_ID_REQUIRED، 404 UNKNOWN_ORDER). أما حالة النجاح الحقيقية فستتطلب عملية دفع فعلية في بيئة PayPal التجريبية (sandbox) مع موافقة المشتري، وهو ما كان مستبعدًا وفق متطلبات الاختبار (لا استدعاءات حقيقية لمزوّدي الدفع).

← النماذج العامة