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

يُنهي طلبًا تم إنشاؤه مسبقًا وأقرّه المشتري في عملية الدفع عبر PayPal (Capture). والخادم وحده يحدّد المبلغ.

أرسلوا رقم الطلب الذي قدّمه `paypal/create-order` في الحقل `order_id` بعد موافقة المشتري على الدفع في PayPal. وفي حال النجاح، يكون الدفع مكتملًا ويُستكمل معالجة طلب الوصول. حالات الخطأ: 400 `ORDER_ID_REQUIRED` (الحقل مفقود)، 404 `UNKNOWN_ORDER` (لا يوجد طلب معروف)، 409 `CAPTURE_NOT_COMPLETED` (الدفع لم يُقَر بعد – يجب على المشتري إنهاء عملية الدفع عبر PayPal)، و502 `PAYPAL_CAPTURE_FAILED` (خطأ في الاتصال مع PayPal). استدعوا النقطة مرة واحدة فقط لكل طلب.

نظرة عامة

الاستدعاء: POST /api/public/access-request/paypal/capture-order. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: order_id (النص (Body)). حالات الخطأ الموثقة: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

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

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

بحد أقصى 10 طلبات كل 15 دقيقة لكل عنوان 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.

السلوك المُتحقَّق منه

بدون `order_id` يُعيد الاستدعاء 400 `ORDER_ID_REQUIRED`، ومع طلب غير معروف 404 `UNKNOWN_ORDER`. وتتطلب حالة النجاح دفعًا حقيقيًا عبر PayPal وافق عليه المشتري.

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

POST /api/public/contactيستقبل طلبًا من نموذج الاتصال بموقع Zentor App الإلكتروني ويحوّله إلى فريق Zentor.POST /api/public/consultationيستقبل طلب استشارة من نموذج موقع Zentor App الإلكتروني.POST /api/public/access-requestيقدّم طلب وصول لباقة (Starter أو المخصصة (Individuell) أو عرض تجريبي لمدة 14 يومًا). ويتطلب ذلك عنوان بريد إلكتروني مؤكَّدًا مسبقًا.POST /api/public/access-request/email/start-verificationيرسل رمز تأكيد مكوّنًا من ستة أرقام وصالحًا لمدة 10 دقائق إلى عنوان البريد الإلكتروني المحدَّد – الخطوة الأولى في طلب الوصول.POST /api/public/access-request/email/verifyيتحقق من الرمز المرسَل عبر البريد الإلكتروني ويُصدر رمز تأكيد لطلب الوصول اللاحق.GET /api/public/access-request/payment-statusيبيّن طرق الدفع المتاحة حاليًا (PayPal، Stripe) لطلب الوصول.GET /api/public/access-request/paypal/configيعرض تهيئة PayPal العامة (مفعّلة، الوضع، العملة) لخطوة الدفع.POST /api/public/access-request/paypal/create-orderيُنشئ طلب شراء عبر PayPal للباقة المختارة.POST /api/public/access-request/stripe/create-checkoutيُنشئ جلسة دفع عبر Stripe للباقة المختارة.POST /api/public/activate-accountيفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.

مقالات ذات صلة

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