Order Change Notification

While creating an order you can provide a URL for the optional callback_url parameter. If set with a valid URL, Tiqets performs an HTTP POST request to it whenever the individual order's status changes (e.g., fulfilled, PDF voucher ready, failed, or canceled).

As cancellations may happen a long time after the order was confirmed this URL should remain accessible until at least after the selected visit date and timeslot.

If you (the distributor) cancel the order, no webhook call is performed. A webhook is only triggered if the cancellation was initiated by Tiqets Customer Service or the product supplier.

The request body contains the Tiqets Order Reference ID of the transitioned order. No response body is needed and the request must be responded with an HTTP 200 status code. Otherwise, we will retry several times (exponential backoff) after 1, 2, 4, and 8 minutes. If all calls fail we will send an email to the distributor to the address we have on file.

As this webhook only provides notification of a change, without including the actual change, the distributor will have to call the Get Order Information endpoint to find out what has changed.

Notification that an order's status has changed.

This webhook is triggered whenever an order transitions to a new status. To obtain details of the change, please follow up with a "Get Order Information" call to fetch the new status and order details.

Payload

application/json

order_reference_idstringOptional

The unique identifier of the order whose status has changed.

Example: 1234567

Responses

200

Webhook successfully received and acknowledged by the supplier.

No content

default

All non-200 responses (e.g., 4xx, 5xx) indicate failure and will trigger a retry using an exponential backoff mechanism.

Payload

{
  "order_reference_id": 1234567
}