Skip to main content
POST

Cancel Checkout Session

Marks an open session as abandoned.
Requires checkout: write and an allowlisted partner key. No signature is needed: cancel carries no body. Send API-Version as on every other checkout call. Or send no credential at all: a session created without one is reached by its id alone, with no credential, so keep the id between you and your buyer.
Cancel when your buyer walks away, so the session cannot later be paid by a stray retry and your own records show why it ended.
An open session does not hold inventory — tickets are only claimed at completion. Cancelling therefore releases nothing and is not required to free stock, but it is still the correct way to close a cart you have abandoned.

Path Parameters

string
required
The session to cancel.

Response

200 with the session, now status: "canceled". Cancellation is terminal. A canceled session cannot be updated or completed — both return 409 invalid_session_state.

A completed session cannot be canceled

Once tickets are issued, this endpoint is the wrong tool and returns 409 invalid_session_state. Cancelling a checkout session is not a refund — it only abandons a cart that was never paid. To refund or cancel a real order, use the organizer’s own tools or the Payments API. Refunds follow the organizer’s policy, not the agent’s.