POST
Create order

Authorizations

Authorization
string
header
required

API key as Bearer token. Sandbox keys start with sk_test_, mainnet keys with sk_live_.

Headers

Idempotency-Key
string

Unique key to make retries safe. Strongly recommended for all write requests.

Body

application/json
merchant_id
string
required
Example:

"mch_3f2a1b0c"

agent_id
string
required
Example:

"agt_7d1e5b2f"

amount
string
required

Amount in USDC

Example:

"25.00"

metadata
object
Example:

Response

Order created

order_id
string
Example:

"ord_9f8e7d6c"

merchant_id
string
Example:

"mch_3f2a1b0c"

agent_id
string
Example:

"agt_7d1e5b2f"

amount
string
Example:

"25.00"

status
enum<string>
Available options:
pending,
paid,
expired,
failed
Example:

"pending"

settlement_address
string
Example:

"0x2f3a4b5c6d7e8f901a2b3c4d5e6f7a8b9c0d1e2f"

expires_at
string<date-time>

Orders expire 10 minutes after creation

created_at
string<date-time>