Получение информации о статусе заказа

Возвращает статус заказа по идентификатору (используется для polling).

Формат запроса

GET https://whitelabel.travel.yandex-net.ru/hotels/booking/orders/{order_id}/status

Параметры запроса

Параметр

Тип

Описание

order_id*

string

Идентификатор заказа.

* Обязательный параметр

Пример запроса

https://whitelabel.travel.yandex-net.ru/hotels/booking/orders/3aa8c5b7-aedf-448f-ae6c-55c76b690cfb/status

Формат ответа

{
  "status": "(string)",
  "payment_url": "(string)",
  "payment_error": "(string)"
}

Параметры ответа

Параметр

Тип

Описание

status

string

Статус заказа. Возможные значения:

  • IN_PROGRESS — в обработке;

  • RESERVED — забронирован;

  • RESERVED_WITH_RESTRICTIONS — забронирован с ограничениями (например, не удалось применить промокоды);

  • AWAITS_PAYMENT — ожидает оплаты;

  • PAYMENT_FAILED — платеж не прошел;

  • CONFIRMED — подтверждено;

  • CANCELLED — отменено (не было мест при резервировании или заказ не был оплачен вовремя);

  • CANCELLED_WITH_REFUND — отменено с возвратом средств (заказ был оплачен, но при подтверждении бронирования произошла ошибка);

  • REFUNDED — возвращено (заказ был подтвержден и оплачен, после чего пользователь его отменил и получил возврат);

  • REFUND_FAILED — возврат средств не удался;

  • FAILED — ошибка.

payment_url

string

Ссылка, по которой должен перейти пользователь для оплаты заказа.

payment_error

string

Ошибка оплаты. Возможные значения:

  • AUTHORIZATION_REJECT — банк отклонил списание;

  • EXPIRED_CARD — истек срок действия карты;

  • FAIL_3DS — ошибка авторизации 3D Secure;

  • LIMIT_EXCEEDED — превышен лимит по операциям с картой;

  • NOT_ENOUGH_FUNDS — на карте недостаточно средств;

  • TRANSACTION_NOT_PERMITTED — этот вид списаний заблокирован для карты;

  • USER_CANCELLED — пользователь закрыл форму оплаты;

  • RESTRICTED_CARD — заблокированная карта;

  • BLACKLISTED — не удалось списать средства;

  • PAYMENT_TIMEOUT — время ожидания платежа истекло;

  • OTHER — другая причина.

Пример ответа

{
  "status": "PAYMENT_FAILED",
  "payment_url": "https://trust-test.yandex.ru/web/payment?purchase_token=130649cdc3b2a525745bfd86868dd63c",
  "payment_error": "FAIL_3DS"
}