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Проверяет код, доставленный по email, и выдаёт токен подтверждения для последующей заявки на доступ.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Активирует новоcозданную учётную запись пользователя и устанавливает первый пароль — запускается по ссылке в приглашающем письме.

Связанные статьи

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