Off-ramp (Sell) APIs

Pre order

Code
POST /papi/v1/ramp/connect/sell/pre-order

Request Body

Field	Type	Mandatory	Remarks
externalOrderId	string	Yes	The unique order id from the partner side. Supports only letters and numbers.
fiatCurrency	string	Yes	fiat currency
cryptoCurrency	string	Yes	crypto currency
amountType	int	Yes	Specify whether the requested amount is in fiat:1 or crypto:2
requestedAmount	string	Yes	Requested amount. Fraction is 8
payMethodCode	string	Yes	The payment method code is from payment method list API
payMethodSubCode	string	Yes	The payment method subcode is from payment method list API
network	string	Yes	crypto network
redirectUrl	string	No	The redirectUrl is for redirecting to your website if order is completed
failRedirectUrl	string	No	The redirectUrl is for redirecting to your website if order is failed
redirectDeepLink	string	No	The redirectDeepLink is for redirecting to your APP if order is completed
failRedirectDeepLink	string	No	The failRedirectDeepLink is for redirecting to your APP if order is failed
clientIp	string	No	The original client IP
clientType	string	No	The original client type: web/mobile
customization	object	No	Customization settings for the current order. Please refer to "Customization".

Response Body

Field	Type	Remarks
link	string	The landing page link of Binance Connect. For information on how to use it, please refer to "Landing page and redirection".
linkExpireTime	timestamp	The expiration time of link

Example

Request Parameters:


Code
{
  "externalOrderId": "8746972922319",
  "fiatCurrency": "EUR",
  "cryptoCurrency": "USDT",
  "amountType": 1,
  "requestedAmount": "100",
  "payMethodCode": "SELL_P2P",
  "payMethodSubCode": "BANK",
  "network": "ETH",
  "redirectUrl": "https://test.examplepartner.com/sell/home",
  "failRedirectUrl": "https://test.examplepartner.com/sell/order/failure",
  "redirectDeepLink": "examplepartner://sell/home",
  "failRedirectDeepLink": "examplepartner://sell/order/failure",
  "clientIp": "154.55.51.218",
  "customization": {
    "LOCK_ORDER_ATTRIBUTES": [2, 3],
    "SKIP_CASHIER": false,
    "AUTO_REDIRECTION": true
  }
}

Response:


Code
{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "link": "https://app.binance.com/uni-qr/qccnt?amount=1300&baseCurrency=EUR&channel=P2P&cryptoCurrency=USDT&externalOrderId=946972925243314539&fiatCurrency=EUR&merchantCode=example-partner&paymentMethodCode=SELL_P2P&paymentmethod=BANK&sign=c267bcfe69d5e263u9ee6e5cdc374e3a958a1d00a06b9efcdf19e33dca3407e4&type=2&utm_campaign=connect_open_api&utm_source=test",
    "linkExpireTime": 1742222312058
  }
}

Was this page helpful?

Last modified on July 7, 2026

Get estimated quote Get payment method list v2

Pre order

Code

POST /papi/v1/ramp/connect/sell/pre-order

Request Body

Field

Type

Mandatory

Remarks

externalOrderId

string

Yes

The unique order id from the partner side. Supports only letters and numbers.

fiatCurrency

string

Yes

fiat currency

cryptoCurrency

string

Yes

crypto currency

amountType

int

Yes

Specify whether the requested amount is in fiat:1 or crypto:2

requestedAmount

string

Yes

Requested amount. Fraction is 8

payMethodCode

string

Yes

The payment method code is from payment method list API

payMethodSubCode

string

Yes

The payment method subcode is from payment method list API

network

string

Yes

crypto network

redirectUrl

string

The redirectUrl is for redirecting to your website if order is completed

failRedirectUrl

string

The redirectUrl is for redirecting to your website if order is failed

redirectDeepLink

string

The redirectDeepLink is for redirecting to your APP if order is completed

failRedirectDeepLink

string

The failRedirectDeepLink is for redirecting to your APP if order is failed

clientIp

string

The original client IP

clientType

string

The original client type: web/mobile

customization

object

Customization settings for the current order. Please refer to "Customization".

Response Body

Field

Type

Remarks

link

string

The landing page link of Binance Connect. For information on how to use it, please refer to "Landing page and redirection".

linkExpireTime

timestamp

The expiration time of link

Code

{
  "externalOrderId": "8746972922319",
  "fiatCurrency": "EUR",
  "cryptoCurrency": "USDT",
  "amountType": 1,
  "requestedAmount": "100",
  "payMethodCode": "SELL_P2P",
  "payMethodSubCode": "BANK",
  "network": "ETH",
  "redirectUrl": "https://test.examplepartner.com/sell/home",
  "failRedirectUrl": "https://test.examplepartner.com/sell/order/failure",
  "redirectDeepLink": "examplepartner://sell/home",
  "failRedirectDeepLink": "examplepartner://sell/order/failure",
  "clientIp": "154.55.51.218",
  "customization": {
    "LOCK_ORDER_ATTRIBUTES": [2, 3],
    "SKIP_CASHIER": false,
    "AUTO_REDIRECTION": true
  }
}

Code

{
  "success": true,
  "code": "000000",
  "message": "success",
  "data": {
    "link": "https://app.binance.com/uni-qr/qccnt?amount=1300&baseCurrency=EUR&channel=P2P&cryptoCurrency=USDT&externalOrderId=946972925243314539&fiatCurrency=EUR&merchantCode=example-partner&paymentMethodCode=SELL_P2P&paymentmethod=BANK&sign=c267bcfe69d5e263u9ee6e5cdc374e3a958a1d00a06b9efcdf19e33dca3407e4&type=2&utm_campaign=connect_open_api&utm_source=test",
    "linkExpireTime": 1742222312058
  }
}