Подтвердить заказ

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

Подтверждает продажу после оплаты на вашей стороне. Билеты становятся оплаченными, в ответе появляются их PIN.

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

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

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

Пример

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

Ответ

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

{
  "data": {
    "id": "3f6c2a1e-8b4d-4c7a-9e2f-1a2b3c4d5e6f",
    "partner_order_id": "ORD-1001",
    "status": "paid",
    "expires_at": null,
    "total": 3000,
    "currency": "KGS",
    "customer": {
      "full_name": "Иван Иванов",
      "email": "ivan@example.com",
      "phone": "+996700000000"
    },
    "created_at": "2026-11-01T14:00:00+06:00",
    "tickets": [
      {
        "id": 884512,
        "event_item_id": 2505,
        "seat_id": 101,
        "zone_id": null,
        "price_id": 4170,
        "section": "Партер",
        "row": "5",
        "seat": "12",
        "price": 1500,
        "status": "paid",
        "pin": "TKGA0100025057382910465",
        "pin_formatted": "TKG-2505-7382910465",
        "paid_at": "2026-11-01T14:07:12+06:00"
      },
      {
        "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": []
  }
}

Как использовать PIN — в разделе Билеты и PIN.

Поведение

• Идемпотентность. Повторный confirm уже оплаченного заказа возвращает его без изменений. При сетевой ошибке подтверждение можно безопасно повторить.
• Запас по времени. Если до окончания брони меньше 10 секунд, подтверждение отклоняется с order_expired.

Ошибки

HTTP	code	Причина	details
404	not_found	Заказ не найден	—
409	order_expired	Бронь истекла или истекает менее чем через 10 секунд	—
409	order_not_held	Заказ отменён или возвращён	status