Отменить бронь

DELETE /api/v1/orders/{orderID}

Снимает неоплаченную бронь. Места и остатки зон сразу возвращаются в продажу.

Тело запроса не нужно.

Параметры пути

Параметр	Тип	Описание
orderID	string	id заказа (UUID)

Пример

curl -X DELETE https://gateway.ticket.kg/api/v1/orders/3f6c2a1e-8b4d-4c7a-9e2f-1a2b3c4d5e6f \
  -H "X-API-Key: $KEY"

Ответ

200 OK, data — объект Order со статусом cancelled.

{
  "data": {
    "id": "3f6c2a1e-8b4d-4c7a-9e2f-1a2b3c4d5e6f",
    "partner_order_id": "ORD-1001",
    "status": "cancelled",
    "expires_at": null,
    "total": 0,
    "currency": "KGS",
    "customer": { "full_name": "Иван Иванов", "email": "ivan@example.com", "phone": "+996700000000" },
    "created_at": "2026-11-01T14:00:00+06:00",
    "tickets": [],
    "refunded_tickets": []
  }
}

Поведение

Текущий статус	Результат
held	Бронь снимается, статус → cancelled
expired, но билеты ещё не удалены автоматически	Билеты удаляются сразу
cancelled, refunded	Ничего не меняется, заказ возвращается как есть
paid	Ошибка 409 order_not_held — используйте возврат

TIP

Снимайте бронь, как только понятно, что покупатель не будет платить. Так места быстрее вернутся в продажу, чем при автоматическом удалении после expires_at.

Ошибки

HTTP	code	Причина
404	not_found	Заказ не найден
409	order_not_held	Заказ уже оплачен