Cancel crypto withdrawal

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

Cancels a withdrawal you submitted while it is still awaiting admin approval. The deducted balance is restored and the order is closed with deposit_canceled.

Once an admin has approved or rejected the withdrawal, you can no longer cancel it here.

Request body type:

type RequestBody = {
  orderId: string;    // the withdrawal order id
  reason?: string;    // optional, max 500 chars
}

Request body example:

{
  "orderId": "69281f0aa263ba8d44fad3b2",
  "reason": "Wrong destination address"
}

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;       // "deposit_canceled" after cancel
  network: string;
  asset: string;
  address: string;
  currencyCode: string;
  amount: number;
  createdAt: Date;
  updatedAt: Date;
}

Response example:

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