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

Завершує (captures) раніше створене замовлення, підтверджене покупцем у PayPal-checkout. Суму встановлює виключно сервер.

Надішліть ID замовлення, отриманий від `paypal/create-order`, у полі `order_id` після того, як покупець підтвердив оплату в PayPal. У разі успіху оплата завершена, і заявка на доступ обробляється далі. Випадки помилок: 400 `ORDER_ID_REQUIRED` (поле відсутнє), 404 `UNKNOWN_ORDER` (немає відомого замовлення), 409 `CAPTURE_NOT_COMPLETED` (оплата ще не підтверджена — покупець повинен завершити PayPal-checkout) і 502 `PAYPAL_CAPTURE_FAILED` (помилка зв’язку з PayPal). Викликайте кінцевий пункт лише один раз на замовлення.

Огляд

Виклик: POST /api/public/access-request/paypal/capture-order. Цей ендпоінт належить до групи «Публічні форми» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: order_id (тіло). Задокументовані випадки помилок: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.

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

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

Не більше 10 запитів за 15 хвилин на IP-адресу.

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

Параметри

order_id(body, string, обов'язково)— ID замовлення PayPal, отриманий від `paypal/create-order`

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

{"order_id":"<PAYPAL_ORDER_ID>"}

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

{"ok":false,"error":"UNKNOWN_ORDER","message":"Невідоме замовлення."}

Коди помилок

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, «Індивідуально» або 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/create-orderСтворює замовлення PayPal для вибраного пакета.POST /api/public/access-request/stripe/create-checkoutСтворює сесію Stripe-checkout для вибраного пакета.POST /api/public/activate-accountАктивує новостворений облiковий запис користувача і встановлює перший пароль — запускається за посиланням у листі-запрошенні.

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

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