Skip to main content
Place an order
Place one order per marketplace sale, for one product: tickets to an event, or seats on one session of an experience. Gomry issues them inside the request and answers with them.
external_ref makes it safe to retry. It is your order id. Send the same external_ref with the same lines and you get the same order back, never a second one. A timeout or a dropped connection is safe to retry as is.
string
required
Your order id. 1 to 128 letters, digits, ., _, : or -. Reusing it with different lines is refused with order_mismatch.
string
required
From products: evt_… or exp_….
string
Experiences only, and required there: the session’s start.utc, from the product’s sessions. An event has one session and needs none.
string
When you held the seats first. The order must match the hold’s session and lines.
array
required
One to 20 lines.
object
required
object
The person the marketplace sold the tickets to, when you know them. Gomry hands the tickets over like a mobile transfer: it emails them the order’s accept link and fills the accept page in for them. The tickets stay in the buyer name until they accept. Send it on every post of the order; the first one Gomry receives is kept. See Delivery.
Seats on an experience session name the session’s start:
Answers 201 with the order.

When an order is refused

Nothing is issued and nothing is owed. The common ones: