public.withdrawals

Create Merchant Withdrawal

Transfers merchant USD-backed stablecoins or native SOL to a pre-approved onchain destination using Utila. Stablecoins use amount_usd; native SOL uses amount. The destination must first be added to the merchant withdrawal whitelist.

post/v1/merchant/withdrawals

Headers

X-Idempotency-Keystring required

Idempotency key for request deduplication

Request body

amountstring
amount_usdstring
chain'SOLANA' | 'TRON' | 'APTOS' | 'BASE' | 'POLYGON' | 'ETHEREUM' | 'OPTIMISM' | 'BSC' required
destination_addressstring required
token'USDC' | 'USDT' | 'SOL' | 'BNB' required

Example request

{
  "amount": "0.250000000",
  "amount_usd": "12.3400",
  "chain": "SOLANA",
  "destination_address": "4vJ9JU1bJJE96FWSJN",
  "token": "BNB"
}

Response

Created

Example response

{
  "data": {
    "transaction_id": "transactions/abc123"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.