Create crypto withdrawal

[POST] /api/v2/merchant-balance/withdrawal

Withdraws amount USD from your merchant balance to address as crypto.

On create, the USD amount is deducted and the order is parked awaiting Fonbnk admin approval before any crypto is broadcast.

The returned order is in deposit_successful.

If the withdrawal is later rejected by an admin, or canceled while still parked, the deducted balance is restored.

Requires the crypto withdrawal feature to be enabled and a verified merchant organization.

Request body type:

type RequestBody = {
  network: string;   // e.g. "POLYGON"
  asset: string;     // e.g. "USDC"
  address: string;   // destination crypto address
  amount: number;    // USD amount to withdraw
}

Request body example:

{
  "network": "POLYGON",
  "asset": "USDC",
  "address": "0x5b7ae3c6c87f4a3f94b35c77233b13191ebfad20",
  "amount": 100
}

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;       // "deposit_successful" while awaiting approval
  network: string;
  asset: string;
  address: string;           // destination crypto address
  currencyCode: string;      // e.g. "POLYGON_USDC"
  amount: number;            // USD amount deducted
  createdAt: Date;
  updatedAt: Date;
}

Response example:

{
  "orderId": "69281f0aa263ba8d44fad3b2",
  "status": "deposit_successful",
  "network": "POLYGON",
  "asset": "USDC",
  "address": "0x5b7ae3c6c87f4a3f94b35c77233b13191ebfad20",
  "currencyCode": "POLYGON_USDC",
  "amount": 100,
  "createdAt": "2025-11-27T09:40:10.001Z",
  "updatedAt": "2025-11-27T09:40:10.500Z"
}