Deposit APIs

Copy page

Initiate deposit

Code
POST /papi/v1/ramp/connect/deposit/initiate

Create a deposit session. Returns a universal link for opening the Binance App authorization page where the user can authorize the Partner to access their deposit addresses.

The externalOrderId serves as an idempotency key. Calling this API multiple times with the same externalOrderId will return the same universal link.

Request Body

Field	Type	Mandatory	Remarks
cryptoCurrency	string	Yes	Crypto currency. E.g. "USDT", "ETH"
networks	string array	Yes	Blockchain networks (one or more). E.g. ["BSC", "ETH", "SOL"]. Use depositEnable from the crypto-network API to check which networks support deposit.
externalOrderId	string	Yes	Partner's unique order ID (idempotency key). Supports only letters, numbers, hyphens and underscores.
amount	string	No	Expected deposit amount (display only, not enforced). This is shown to the user on the authorization page for reference.
redirectUrl	string	No	Partner web redirect URL. The user will be redirected to this URL after authorization in the Binance App.
redirectDeepLink	string	No	Partner native app deeplink. The user will be redirected to this deeplink after authorization in the Binance App.

Response Body

Field	Type	Remarks
link	string	Binance App universal link. Redirect the user to this link to open the deposit authorization page in the Binance App.
linkExpireTime	timestamp	The expiration time of the link (epoch milliseconds). After this time, the user can no longer authorize this deposit session.

Example

Request Parameters:

Code
{
  "cryptoCurrency": "USDT",
  "networks": ["BSC", "ETH", "SOL"],
  "externalOrderId": "dep-20260421-001",
  "amount": "100.5",
  "redirectUrl": "https://trustwallet.com/deposit-callback",
  "redirectDeepLink": "trustwallet://deposit-callback"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "link": "https://app.binance.com/mp/web?appId=VzUjjQ&startPagePath=cGFnZXMvb24tY2hhaW4tZGVwb3NpdC9pbmRleA&merchantCode=connect-trustwallet&externalOrderId=dep-20260421-001",
    "linkExpireTime": 1745352000000
  }
}

Example - Single network

Request Parameters:

Code
{
  "cryptoCurrency": "ETH",
  "networks": ["ETH"],
  "externalOrderId": "dep-20260422-002"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "link": "https://app.binance.com/mp/web?appId=VzUjjQ&startPagePath=cGFnZXMvb24tY2hhaW4tZGVwb3NpdC9pbmRleA&merchantCode=connect-trustwallet&externalOrderId=dep-20260422-002",
    "linkExpireTime": 1745438400000
  }
}