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

يُنشئ طلب شراء عبر PayPal للباقة المختارة.

أرسلوا رمز الباقة في الحقل `package` واختياريًا `email` الخاص بمقدّم الطلب. ويُحدَّد المبلغ من جانب الخادم حصرًا عبر الباقة. وفي حال النجاح، يحتوي الرد في الكائن `data` على رقم طلب PayPal `order_id` إضافةً إلى `amount_cents` و`currency`؛ وبواسطة `order_id` يوافق المشتري على الدفع في عملية الدفع عبر PayPal. ثم تنهون الدفع عبر `POST /api/public/access-request/paypal/capture-order`. تؤدي باقة غير صالحة إلى 400 `INVALID_PACKAGE`، وعنوان بريد إلكتروني غير صالح إلى 400 `INVALID_EMAIL`. وإذا كان PayPal غير متاح حاليًا، تردّ النقطة بـ 503 `PAYPAL_NOT_READY`. والنقطة محدودة بـ10 طلبات كل 15 دقيقة لكل عنوان IP. وينشئ كل استدعاء ناجح طلبًا جديدًا؛ فلا تكرروه تلقائيًا.

نظرة عامة

الاستدعاء: POST /api/public/access-request/paypal/create-order. تنتمي نقطة النهاية هذه إلى مجموعة «النماذج العامة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: package (النص (Body)). حالات الخطأ الموثقة: 503 PAYPAL_NOT_READY. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

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

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

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

المعلمات

package(body, string، إلزامي)— رمز الباقة المختارة

مثال طلب

{"package":"starter"}

مثال استجابة

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal ist derzeit nicht verfügbar."}

رموز الأخطاء

503 PAYPAL_NOT_READY — خدمة PayPal غير متاحة حاليًا.

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

بدون ربط PayPal متاح، يُعيد الاستدعاء 503 `PAYPAL_NOT_READY`. وتتطلب حالة النجاح دفعًا حقيقيًا عبر 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/capture-orderيُنهي طلبًا تم إنشاؤه مسبقًا وأقرّه المشتري في عملية الدفع عبر PayPal (Capture). والخادم وحده يحدّد المبلغ.POST /api/public/access-request/stripe/create-checkoutيُنشئ جلسة دفع عبر Stripe للباقة المختارة.POST /api/public/activate-accountيفعّل حسابًا جديدًا تم إنشاؤه ويضبط كلمة المرور الأولى – يُطلَق عبر الرابط في بريد الدعوة الإلكتروني.

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

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