Вернуть билеты

POST /api/v1/orders/{orderID}/refund

Возвращает оплаченные билеты: все или выбранные. Места возвращаются в продажу, PIN перестают действовать. Подробнее — в руководстве Возвраты.

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

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

Тело запроса

Необязательно.

Поле	Тип	Описание
ticket_ids	integer[]	ID билетов из tickets[].id. Если тело не передано или массив пуст — возвращаются все оплаченные билеты

Примеры

Вернуть все билеты:

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

Вернуть один билет:

curl -X POST https://gateway.ticket.kg/api/v1/orders/3f6c2a1e-8b4d-4c7a-9e2f-1a2b3c4d5e6f/refund \
  -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticket_ids": [884512]}'

Ответ

200 OK, data — объект Order.

• После полного возврата — статус refunded, tickets пуст.
• После частичного — статус paid, возвращённые билеты перенесены в refunded_tickets.

{
  "data": {
    "id": "3f6c2a1e-8b4d-4c7a-9e2f-1a2b3c4d5e6f",
    "partner_order_id": "ORD-1001",
    "status": "paid",
    "expires_at": null,
    "total": 1500,
    "currency": "KGS",
    "customer": { "full_name": "Иван Иванов", "email": "ivan@example.com", "phone": "+996700000000" },
    "created_at": "2026-11-01T14:00:00+06:00",
    "tickets": [
      {
        "id": 884513,
        "event_item_id": 2505,
        "seat_id": 102,
        "zone_id": null,
        "price_id": 4170,
        "section": "Партер",
        "row": "5",
        "seat": "13",
        "price": 1500,
        "status": "paid",
        "pin": "TKGA0100025051938475620",
        "pin_formatted": "TKG-2505-1938475620",
        "paid_at": "2026-11-01T14:07:12+06:00"
      }
    ],
    "refunded_tickets": [
      {
        "event_item_id": 2505,
        "seat_id": 101,
        "section": "Партер",
        "row": "5",
        "seat": "12",
        "price": 1500,
        "refunded_at": "2026-11-03T10:22:41+06:00"
      }
    ]
  }
}

Ошибки

HTTP	code	Причина	details
400	invalid_json	Тело — невалидный JSON	—
404	not_found	Заказ не найден	—
409	order_not_held	Заказ не в статусе paid	status
409	refund_not_allowed	Сеанс уже начался	—
409	refund_not_allowed	Среди билетов есть использованные	ticket_ids
409	refund_not_allowed	Нет билетов для возврата	—
422	validation_error	Билеты не из этого заказа или не оплачены	ticket_ids