Customer Order Authorization

Some send orders require explicit partner authorization before they can be processed. This mechanism allows a designated partner employee to review and approve or reject outgoing cryptocurrency transfers on behalf of the partner.

Overview

When a send order requires authorization, it is created in a pending state with an authorizations array inside the send node. The order will not be processed until all pending authorizations are resolved.

The authorization flow is:

A send order is created via Create Order and the response includes an authorizations array with one or more entries in pending state.
The partner employee reviews the pending authorization using Search Partner Authorizations to find orders awaiting approval.
The partner employee approves or rejects the authorization via Update Order Authorization.
If approved, the order proceeds to processing. If rejected, the order is cancelled.

Scope and Permissions

Authorization operations require the partner_order_authorization scope. This scope is intended for a specific partner employee role whose sole responsibility is to authorize or reject orders.

⚠️
Dedicated Authorization Role
The partner_order_authorization scope should be assigned only to partner employees responsible for reviewing and authorizing customer orders. A user with this scope will only be able to list pending authorizations and approve or reject them — they will not have access to create orders or perform other partner operations unless additional scopes are granted.

Authorization Object

Each entry in the authorizations array contains:

Field	Type	Description
`id`	string	Unique authorization identifier
`type`	string	Authorization type (e.g., `partner`)
`state`	string	Current state: `pending`, `approved`, or `rejected`
`expires_at`	string	ISO 8601 timestamp after which the authorization expires
`signed_at`	string	ISO 8601 timestamp when the authorization was signed. Present only after the authorization has been approved or rejected

Authorization States

State	Description
`pending`	Awaiting a decision from the partner employee
`approved`	The partner employee approved the order, and it will proceed to processing
`rejected`	The partner employee rejected the order, and it will be cancelled

Applicable Operations

Authorizations apply exclusively to send orders. Buy, sell, swap, and investment orders do not require partner authorization.

Related Endpoints

Endpoint	Description
Search Partner Authorizations	List orders filtered by authorization state
Update Order Authorization	Approve or reject a pending authorization
Order Details	View full order details including the `authorizations` array