All orders created with the create order endpoint require confirmation, some orders require a confirmation code (see requires_confirmation_code in the Create Order endpoint); this endpoint is used for confirming orders.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
The response body mirrors the order envelope returned by Create Order and Order Details, with updated state, last_updated_at, and (for send-family operations) submitted_at fields. Confirming an order with an embedded auto-redeem (swap / send / sell) also returns the nested redeem_investment block that was executed as part of the operation.
Reference ID and customer amountThe
reference_idandcustomerfields in the request body are optional:
reference_idmay be supplied here only if it was not sent on order creation.customerrepresents the real amount accepted by the customer after the partner's fees are applied. It is echoed back in the response under the operation block.
Error Responses
Error responses include error_code, error_msg, and a request_id field for tracking. Some errors may include additional context fields depending on the error type.
| Status | Error Code | Description |
|---|---|---|
| 400 | insufficient_funds | Customer does not have enough balance |
| 400 | expired_order | The order has expired |
| 400 | invalid_order_state | The order is not in a state that allows confirmation (for example, already confirmed or cancelled) |
| 400 | invalid_parameters | The request body is malformed (for example, an invalid confirmation_code or a reference_id that was already set on creation) |
| 400 | quote_amount_too_high | The quote amount computed at confirmation time exceeds the maximum allowed (max_amount, requested_amount) |
| 403 | forbidden | The application (or customer token) does not contain the required scope for the operation |
| 404 | not_found | The order was not found |
| 500 | internal_error | An internal service failed while confirming the order. Safe to retry. |