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. "POLYGON"
  asset: string;     // e.g. "USDC"
  amount: number;    // amount of crypto to send in native units
}

Request body example:

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

Response type:

type Response = {
  orderId: string;
  status: OrderStatus;       // "deposit_awaiting" on create
  network: string;
  asset: string;
  currencyCode: string;      // e.g. "POLYGON_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": "POLYGON",
  "asset": "USDC",
  "currencyCode": "POLYGON_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"
}