Create a checkout
Returns a hosted checkout_url to send the buyer to. Inventory is held
only until expires_at.
For a reserved-seating event, pass section_id (from
GET /events/{id}/sections); omitting it is a 400 rather than a
general-admission fallback. The seats the buyer was given come back in
assigned_seats.
bearerAuthAuthorizationBearer <token>Authorization: Bearer hh_live_.... Create and revoke keys in
Organizer → Settings → API. A key carries full access to its partner's
data, including refunds and promo codes — treat it as a production
credential and keep it server-side.
application/json- body
event_id*stringuuidquantity*integer1 <= valuecustomer*success_url*stringWhere the buyer lands after paying.
uricancel_url?stringuritier_id?stringDefaults to the event's first sellable tier.
uuidsection_id?stringRequired for reserved-seating events. Seats are assigned best-available within it.
uuidCheckout created.
application/json- response
data?curl -X POST 'https://hanghut.com/api/v1/checkouts' \ -H 'Content-Type: application/json' \ -d '{ "event_id": "a7a26ff2-e851-45b6-9634-d595f45458b7", "quantity": 1, "customer": { "email": "user@example.com", "name": "string" }, "success_url": "http://example.com"}'{ "data": { "checkout_id": "a0db819d-3316-4040-b9b7-2c905552650c", "checkout_url": "http://example.com", "expires_at": "2019-08-24T14:15:22Z", "assigned_seats": [ { "section": "string", "row": "string", "seat": "string", "label": "string" } ] }}Check in a ticket POST
Admits the holder: sets `status` to `used` and stamps `checked_in_at`, then dispatches `ticket.checked_in`. Note the vocabulary: the *status* becomes `used`, while the event and the timestamp field are named `checked_in`. There is no `checked_in` status value. Not idempotent — a second call is a 409, which is what makes it usable as a turnstile.
Create an event POST
A venue event needs coordinates. Send `latitude` and `longitude`, or an `address` that geocodes — if geocoding is unavailable and no coordinates were sent, the request is rejected rather than stored without a location.