POST/api/public/access-request/stripe/create-checkout

يُنشئ جلسة دفع عبر Stripe للباقة المختارة.

أرسلوا رمز الباقة في الحقل `package`، واختياريًا `email` الخاص بمقدّم الطلب، وفي `payment_method_types` طرق الدفع المرغوبة (الافتراضي: بطاقة؛ أو الخصم المباشر SEPA إذا كان مفعّلًا). وفي حال النجاح، يحتوي الرد في الكائن `data` على `session_id` و`url` صفحة الدفع عبر Stripe، التي تحوّلون المشتري إليها. ويُحدَّد المبلغ من جانب الخادم حصرًا. تؤدي باقة غير صالحة إلى 400 `INVALID_PACKAGE`. وإذا كان Stripe غير متاح حاليًا، تردّ النقطة بـ 503 `STRIPE_NOT_READY`. والنقطة محدودة بـ10 طلبات كل 15 دقيقة لكل عنوان IP. وينشئ كل استدعاء ناجح جلسة جديدة؛ فلا تكرروه تلقائيًا.

نظرة عامة

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

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

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

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

المعلمات

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

مثال طلب

{"package":"starter"}

مثال استجابة

{"ok":false,"error":"STRIPE_NOT_READY","message":"Stripe-Zahlung ist momentan nicht verfügbar."}

رموز الأخطاء

503 STRIPE_NOT_READY — خدمة Stripe غير متاحة حاليًا.

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

بدون ربط Stripe متاح، يُعيد الاستدعاء 503 `STRIPE_NOT_READY`. وتتطلب حالة النجاح دفعًا حقيقيًا عبر Stripe.

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

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

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

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