Skip to main content
POST
Withdraw merchant balance

Overview

Creates a withdrawal from your withdrawal balance to a supported on-chain address. Withdrawals draw from the withdrawal balance only — not directly from the collection balance. If the needed funds are still in the collection balance, move them first via POST /v1/merchant/balance/transfer.
Provide a unique X-Idempotency-Key for each withdrawal attempt so retries do not create duplicate transfers.
Before creating a withdrawal, check Get Merchant Balance and validate the destination chain with List Supported Chains.
Only USDT on POLYGON is withdrawal-enabled right now. Use the token-level metadata from GET /v1/supported-chains to validate supported combinations before submitting a withdrawal.

Authentication

X-Api-Key
string
required
Your merchant API key

Headers

X-Idempotency-Key
string
required
Unique request identifier used to deduplicate retries.Example: withdrawal-20260310-0001

Request Body

amount_usd
string
required
Amount to withdraw in USD decimal format.Example: 12.3400
token
string
required
Token to send on-chain.Allowed values: USDC, USDT
chain
string
required
Destination chain for the withdrawal.Allowed values: SOLANA, TRON, APTOS, BASE, POLYGON, ETHEREUM
destination_address
string
required
Address that will receive the withdrawal.Example: 4vJ9JU1bJJE96FWSJN
Make sure the address format matches the selected chain and token pair.

Request Examples

Response

data
object
Withdrawal creation result.

Success Response

Error Responses