Резервування

POST /reservations · дозвіл reservations:write

Резерв утримує місця 15 хвилин, поки покупець вводить дані. Крок необовʼязковий — можна одразу створювати платіж, — але на подіях, де квитки розбирають швидко, він рятує від ситуації «покупець заповнив форму, а місць уже немає».

Запит

curl -X POST https://aoa.com.ua/api/v1/reservations \
  -H "Authorization: Bearer aoa_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "eventId": "a1b2c3",
    "tickets": [
      { "ticketTypeId": "clx9ticket001", "quantity": 2 }
    ]
  }'

Відповідь

{
  "data": {
    "reservationId": "rsv_Xk3mQp7vR2nT8wL5yB1zC4dA",
    "eventId": "a1b2c3",
    "expiresAt": "2026-07-30T12:49:56.789Z",
    "remaining": {
      "clx9ticket001": 61
    }
  }
}

Коли місць не вистачає

Резерв або створюється повністю, або не створюється взагалі — часткових резервів не буває. Якщо квитків менше, ніж просите:

{
  "error": {
    "code": "conflict",
    "message": "Залишилось лише 1 квиток"
  }
}

Візьміть актуальні залишки з /availability і запропонуйте покупцеві меншу кількість. Повторювати той самий запит без змін немає сенсу.

Життєвий цикл резерву

• Скасувати резерв вручну не можна — окремого ендпоінта немає. Якщо покупець передумав, просто не використовуйте резерв: за 15 хвилин місця повернуться самі.
• Успішний /checkout з цим резервом споживає його.
• Якщо оплата не створилась через сторонню причину — скажімо, невалідний промокод — резерв залишається живим. Виправте дані й спробуйте ще раз із тим самим reservationId.