FAQ

Common questions from partners running UAT against the sandbox, once basic connectivity (events/tickets/categories ingest, reservation → guest data → booking, and booking-order polling) is already working end-to-end.

Fulfilment

What is the standard fulfilment flow after a booking is confirmed?

Fulfilment status is exposed through a single field: logistic_status on the bookingorder resource. You don't need to track a separate combination of statuses — just poll logistic_status until it reaches completed. See Resource status for the full list of values, and E-tickets download API for the recommended polling/filter pattern (logistic_status=completed).

E-tickets / PDFs typically become available in download_items once the bookingorder reaches completed — there's no fixed "X hours before the event" rule; it depends on when the supplier/venue releases the tickets.

For invoice payment, how does financial status progress and does it affect ticket release?

In sandbox, you can already self-serve fulfilment for testing using the autofulfil magic word in booking_reference — see How to auto fulfil an order to test it? for the details and limits.

You can email support@xs2event.com to have a booking order fulfilled for testing.

If fulfilment fails or is delayed, what should I do?

Reach out to support@xs2event.com with the booking_reference (or bookingorder_id) and we'll investigate and escalate as needed.

Webhooks vs. polling

Yes, see Webhooks

Reservations (hold time)

How long is a reservation valid after POST /reservations?

valid_until is always returned in the reservation response. See Booking flow for the full reservation lifecycle.

If you don't complete the booking before expiry, the reservation is automatically released — there's no need to call DELETE /reservations yourself for the normal expiry case.

Can I extend or refresh a hold, or do I need to create a new reservation?

Extending or refreshing a hold isn't supported — instead, delete the old reservation and create a new one.

For guest fields marked pre_checkout vs pre_download, which are mandatory when?

• pre_checkout: required at booking time — the booking can't be completed without these.
• pre_download: required before we can issue tickets, but not before booking.

There's currently no public API to submit pre_download guest data — we'll collect it from you directly, or you can supply it via the portal. See Guest data for the full field list and conditions.

Catalogue & testing

Can you recommend sandbox events for UAT?

Check the test portal directly rather than relying on a fixed list here — sandbox inventory (hospitality, grandstand/GA, eticket/mobile/paper) changes regularly.

Are ticket prices (net_rate, face_value) always in minor units?

Yes — net_rate and face_value are always in minor units (e.g. cents) for EUR/GBP in sandbox.

Which currencies can I expect on /tickets (currency_code)?

Typically EUR, USD, AED, GBP, and SGD, depending on the event/supplier. Invoices are always issued in EUR regardless of the ticket currency.