POST /bookings/confirm

Seyaha calls POST /bookings/confirm after a successful payment. This converts the temporary hold (created by POST /bookings/reserve) into a confirmed booking on your platform.

Request

POST /bookings/confirm
Authorization: Bearer <auth_key>
Content-Type: application/json

Request body

Field	Type	Required	Description
`reservationConfirmationCode`	string	Yes	The code returned by `POST /bookings/reserve` for this booking
`contact`	object	No	Customer contact details (same shape as in reserve)
`resellerReference`	string	No	Seyaha’s internal booking `_id`

{
  "reservationConfirmationCode": "HOLD-2026-0001",
  "contact": {
    "fullName": "Jane Smith",
    "emailAddress": "[email protected]",
    "phoneNumber": "+966501234567"
  },
  "resellerReference": "67c896a6639e6ff76dd2f882"
}

Response

200 OK
Content-Type: application/json

Response body

Field	Type	Required	Description
`externalBookingId`	string	Yes	Your permanent booking reference. Seyaha stores this and sends it back when the customer cancels.
`status`	string	Yes	Should be `"CONFIRMED"`
`uuid`	string	No	Your internal UUID
`productId`	string	No
`optionId`	string	No
`availabilityId`	string	No
`contact`	object	No
`tickets`	array	No	Required when `handles_ticket_delivery: true` on your integration (see below)

{
  "uuid": "res_7f3a9c",
  "status": "CONFIRMED",
  "externalBookingId": "BK-2026-9999",
  "productId": "product_abc",
  "optionId": "option_standard",
  "availabilityId": "avail_2026-07-15-10",
  "contact": {
    "fullName": "Jane Smith",
    "emailAddress": "[email protected]",
    "phoneNumber": "+966501234567"
  }
}

Ticket delivery

If you registered your integration with handles_ticket_delivery: true, include a tickets array in this response. Seyaha stores the delivery options and forwards them to the customer.

Ticket object

Field	Type	Description
`redemptionMethod`	string	e.g. `"DIGITAL"`, `"PRINT"`
`deliveryOptions`	array	List of delivery items (see below)

Delivery option object

Field	Type	Description
`deliveryFormat`	string	`QRCODE`, `CODE128`, `PDF_URL`, `AZTEC`, `EAN13`
`deliveryMethod`	string	`TICKET` or `VOUCHER`
`deliveryValue`	string	QR content, PDF URL, or barcode data

{
  "externalBookingId": "BK-2026-9999",
  "status": "CONFIRMED",
  "tickets": [
    {
      "redemptionMethod": "DIGITAL",
      "deliveryOptions": [
        {
          "deliveryFormat": "QRCODE",
          "deliveryMethod": "TICKET",
          "deliveryValue": "https://tickets.yourplatform.com/qr/BK-2026-9999"
        },
        {
          "deliveryFormat": "PDF_URL",
          "deliveryMethod": "VOUCHER",
          "deliveryValue": "https://tickets.yourplatform.com/pdf/BK-2026-9999"
        }
      ]
    }
  ]
}

Implementation notes

externalBookingId must be permanent and unique. Seyaha stores it immediately and uses it as the key when calling POST /bookings/{externalBookingId}/cancel. Never reuse booking IDs, even for cancelled bookings.

If confirm fails (e.g. the hold expired between payment and confirm), Seyaha logs the error but does not reverse the payment. The booking is marked as paid on Seyaha’s side. You should handle this case gracefully — either still confirm the booking or contact Seyaha support to reconcile.

Timeout: 5 seconds (HEALTHY) / 10 seconds (DEGRADED)
If you cannot find the reservationConfirmationCode, return 400 with a descriptive message.
Seyaha calls this endpoint once per booking — do not create duplicate bookings if called more than once with the same code.

Dashboard Guide

Developer Integration

API Reference

POST /bookings/confirm

Request

Request body

Response

Response body

Ticket delivery

Ticket object

Delivery option object

Implementation notes

​Request

​Request body

​Response

​Response body

​Ticket delivery

​Ticket object

​Delivery option object

​Implementation notes

Request

Request body

Response

Response body

Ticket delivery

Ticket object

Delivery option object

Implementation notes