Create crypto deposit

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

Opens a crypto deposit.

Send amount of the selected asset on-chain to the returned address, then submit the transaction hash with Confirm crypto deposit.

Once confirmed, your USD merchant balance is credited 1:1 from the asset's USD price.

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

Request body type:

type RequestBody = {
  network: string;   // e.g. "CELO"
  asset: string;     // e.g. "USDC"
  amount: number;    // amount of crypto to send in native units
}

Request body example:

{
  "network": "CELO",
  "asset": "USDC",
  "amount": 100
}

Take the pair from Get crypto deposit options. Only six pairs are accepted here — USDT and USDC on Celo, Ethereum and BNB — and anything else, POLYGON included, is refused with MERCHANT_BALANCE_DEPOSIT_ASSET_UNSUPPORTED even though the order flows support it.

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;       // "deposit_awaiting" on create
  network: string;
  asset: string;
  currencyCode: string;      // e.g. "CELO_USDC"
  address: string;    // send the crypto here
  amount: number;    // crypto amount to send
  expiresAt: Date;
  createdAt: Date;
  updatedAt: Date;
}

Response example:

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

The deposit expires at expiresAt if nothing arrives. You can cancel it before then.