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.
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.