Cancel order

POST /api/v1/orders/:order_id/cancel tenant key

Cancels an unpaid order (PENDING_PAYMENT only) and releases its card(s) so they can be re-quoted. Requires a TENANT API key. Idempotent — cancelling an already-CANCELLED order returns success. Committed / in-flight / fulfilled orders are rejected (409).

Try it POST /api/v1/orders/0/cancel write

These inputs are shared across all docs pages — an id entered here carries over.

response

Not run yet — press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).

curl (tracks the inputs above)
curl -X POST 'https://service.rip.fun/api/v1/orders/0/cancel' \
  -H 'X-API-Key: rip_…'

Response fields (data)

FieldDescription
(serialized order)The order with status CANCELLED (same shape as GET /orders/:order_id)

Errors

StatusCodeWhen
400invalid order_idorder_id is not a positive integer
404order not foundno such order for this tenant
409cannot be cancelledorder is not PENDING_PAYMENT (already committed / fulfilled)

See Errors for the response envelope and the full code list.