Confirm crypto deposit

[POST] /api/v2/merchant-balance/deposit/confirm

Submits the on-chain transaction hash for a previously created deposit.

The order moves to deposit_validating and is credited once the transfer is confirmed on-chain.

The hash is single-use.

Request body type:

type RequestBody = {
  orderId: string;   // the deposit order id
  hash: string;      // the on-chain transaction hash
}

Request body example:

{
  "orderId": "69281d944a1db009177f0198",
  "hash": "0x9f8b1a2c3d4e5f60718293a4b5c6d7e8f90112233445566778899aabbccddeeff"
}

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;       // "deposit_validating" after confirm
  network: string;
  asset: string;
  currencyCode: string;
  address: string;
  amount: number;
  hash?: string,
  expiresAt: Date;
  createdAt: Date;
  updatedAt: Date;
}

Response example:

{
  "orderId": "69281d944a1db009177f0198",
  "status": "deposit_validating",
  "network": "CELO",
  "asset": "USDC",
  "currencyCode": "CELO_USDC",
  "address": "0x5b7ae3c6c87f4a3f94b35c77233b13191ebfad20",
  "amount": 100,
  "hash": "0x9f8b1a2c3d4e5f60718293a4b5c6d7e8f90112233445566778899aabbccddeeff",
  "expiresAt": "2025-11-27T10:29:56.167Z",
  "createdAt": "2025-11-27T09:29:56.167Z",
  "updatedAt": "2025-11-27T09:31:12.402Z"
}