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

Створює замовлення PayPal для вибраного пакета.

Надішліть код пакета в полі `package` і опціонально `email` заявника. Сума визначається виключно на стороні сервера на основі пакета. У разі успіху відповідь містить в об’єкті `data` ID замовлення PayPal `order_id`, а також `amount_cents` і `currency`; за допомогою `order_id` покупець підтверджує оплату в PayPal-checkout. Потім ви завершуєте оплату через `POST /api/public/access-request/paypal/capture-order`. Недійсний пакет призводить до коду 400 `INVALID_PACKAGE`, недійсна email-адреса — до коду 400 `INVALID_EMAIL`. Якщо PayPal наразі недоступний, кінцевий пункт відповідає кодом 503 `PAYPAL_NOT_READY`. Кінцевий пункт обмежено 10 запитами за 15 хвилин на IP-адресу. Кожен успішний виклик створює нове замовлення; не повторюйте його автоматично.

Огляд

Виклик: POST /api/public/access-request/paypal/create-order. Цей ендпоінт належить до групи «Публічні форми» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: package (тіло). Задокументовані випадки помилок: 503 PAYPAL_NOT_READY. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.

Автентифікація та захист

Автентифікація не потрібна

Ідемпотентний: Ні

Параметри

package(body, string, обов'язково)— Код вибраного пакета

Приклад запиту

{"package":"starter"}

Приклад відповіді

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal зараз недоступний."}

Коди помилок

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, «Індивідуально» або 14-денна демоверсія). Потрібна попередньо підтверджена email-адреса.POST /api/public/access-request/email/start-verificationНадсилає шестизначний код підтвердження, дійсний 10 хвилин, на вказану email-адресу — перший крок заявки на доступ.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Завершує (captures) раніше створене замовлення, підтверджене покупцем у PayPal-checkout. Суму встановлює виключно сервер.POST /api/public/access-request/stripe/create-checkoutСтворює сесію Stripe-checkout для вибраного пакета.POST /api/public/activate-accountАктивує новостворений облiковий запис користувача і встановлює перший пароль — запускається за посиланням у листі-запрошенні.

Споріднені статті

← Публічні форми