Get crypto withdrawal

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

Fetches a single withdrawal order by id, for status polling.

Request query params type:

type QueryParams = {
  orderId: string;   // the withdrawal order id
}

Request URL example:

GET /api/v2/merchant-balance/withdrawal?orderId=69281f0aa263ba8d44fad3b2

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;
  network: string;
  asset: string;
  address: string;
  currencyCode: string;
  amount: number;
  hash?: string;
  createdAt: Date;
  updatedAt: Date;
}

Response example:

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