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يفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.