Deposit APIs

Copy page

Query deposit authorization

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

Query the authorization status of a deposit session. After the user opens the Binance App via the universal link, this API returns the current status and, once authorized, the deposit addresses for all requested networks.

Polling contract: Poll this API every 2-3 seconds. Stop polling when the status transitions from 0 (INIT) to a terminal state: 1 (AUTHORIZED), 2 (REJECTED), or 3 (EXPIRED).

Note: Webhook is the primary delivery mechanism for authorization results. Polling is available as a fallback. See Deposit Webhook for details.

Request Body

Field	Type	Mandatory	Remarks
externalOrderId	string	Yes	Partner's unique order ID (same as the one used in /deposit/initiate).

Response Body

Field	Type	Remarks
status	int	Authorization status. Please refer to "Deposit authorization status".
depositAddresses	object array	Deposit addresses per network. Only present when status = 1 (AUTHORIZED). Refer to DepositAddressObject.
cryptoCurrency	string	Crypto currency
expireTime	timestamp	Authorization expiry time (epoch milliseconds)

DepositAddressObject

Field	Type	Remarks
depositAddress	string	Deposit address for this network
network	string	Blockchain network. E.g. "BSC", "ETH", "SOL"
addressTag	string	Address memo/tag (for networks like XRP, XLM, etc.). Null if not required
minAmount	string	Minimum deposit amount for this network. Deposits below this amount may not be credited

Example - INIT (waiting for user authorization)

Request Parameters:

Code
{
  "externalOrderId": "dep-20260421-001"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "status": 0,
    "depositAddresses": null,
    "cryptoCurrency": "USDT",
    "expireTime": 1745352000000
  }
}

Example - AUTHORIZED (deposit addresses obtained)

Request Parameters:

Code
{
  "externalOrderId": "dep-20260421-001"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "status": 1,
    "depositAddresses": [
      {
        "depositAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "network": "BSC",
        "addressTag": null,
        "minAmount": "0.01"
      },
      {
        "depositAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "network": "ETH",
        "addressTag": null,
        "minAmount": "0.01"
      },
      {
        "depositAddress": "HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH",
        "network": "SOL",
        "addressTag": null,
        "minAmount": "0.01"
      }
    ],
    "cryptoCurrency": "USDT",
    "expireTime": 1745352000000
  }
}

Example - REJECTED (user rejected authorization)

Request Parameters:

Code
{
  "externalOrderId": "dep-20260421-001"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "status": 2,
    "depositAddresses": null,
    "cryptoCurrency": "USDT",
    "expireTime": 1745352000000
  }
}

Example - EXPIRED (authorization window expired)

Request Parameters:

Code
{
  "externalOrderId": "dep-20260421-001"
}

Response:

Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "status": 3,
    "depositAddresses": null,
    "cryptoCurrency": "USDT",
    "expireTime": 1745352000000
  }
}