Create order
On this page
POST
/cash/v1/merchant/exchange/orders Auth: API key (Bearer)exchange:writeTurns a quote into an order and returns the deposit instructions.
What to do with the response
Send exactly paymentAmount of the source asset to paymentAddress (and include paymentExtraId as memo/tag when present) before expiresAt. Sending a different amount, a different asset, or after expiry is handled by the rules shown on the order page and may require a refund via refundAddress.
Notes
- Orders belong to the API key's owner and appear in that account's order list.
- Address and memo validation errors return
400 CASH_ORDER_RECEIVING_ADDRESS_INVALID/CASH_QUOTE_EXTRA_FIELDS_INVALID; an expired or already-usedquoteIdreturns409 CASH_QUOTE_EXPIRED/CASH_QUOTE_ALREADY_USED. - Same contract as the website's
POST /cash/v1/orders. - Pair assertion (`expected`): send the pair and amount your customer confirmed. Any difference from the quote returns
409 CASH_ORDER_EXPECTATION_MISMATCHwitherror.details.mismatcheslisting only the field names (e.g.["fromNetwork"]). Nothing is created in that case: no order, no provider order, and the quote stays usable, so fix the mismatch or request a new quote and confirm again, then retry with a new (the 409 is stored under the original key). A malformed (missing or extra field, non-string or non-positive ) returns with . Omitting keeps the previous behaviour. Live and sandbox () keys behave the same.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| Idempotency-Key | header | string | yes | Unique per order attempt; the same key returns the same order. |
| quoteId | body | string | yes | An unexpired quote id. |
| receivingAddress | body | string | yes | Address on the target network that receives toAmount. |
| refundAddress | body | string | no | Address on the source network for refunds if the exchange cannot complete. |
| receivingExtraId | body | string | no | Memo / tag for the receiving address when the target network requires one. |
| refundExtraId | body |