Webhook

Request Headers

Field	Type	Remarks
X-BN-Connect-Timestamp	timestamp	timestamp
X-BN-Connect-Signature	string	SHA256withRSA(requestBody + X-Connect-Timestamp)
X-BN-Connect-For	string	Same with your client id (X-Tesla-ClientId)

Request Body

Field	Type	Remarks
externalOrderId	string	The unique order id from the partner side.
type	int	1: buy, 3: send
status	int	INIT(0) ON_RAMP_PROCESSING(1) ON_RAMP_COMPLETED(2) WITHDRAW_INIT(10) WITHDRAW_PROCESSING(11) COMPLETED(20) WITHDRAW_ABANDONED(96) ON_RAMP_FAILED(97) WITHDRAW_FAILED(98) FAILED(99)
payMethodCode	string	The payment method code is from payment method list API
payMethodSubCode	string	The payment method sub code is from payment method list API
fiatCurrency	string	fiat currency
cryptoCurrency	string	crypto currency
fiatAmount	string	fiat amount
cryptoAmount	string	crypto amount
feeAmount	string	fee amount
feeCurrency	string	fee currency, USD or crypto
revenueAmount	string	partner revenue amount
revenueCurrency	string	partner revenue currency, USD or crypto
networkFee	string	network fee amount
withdrawWalletAddress	string	withdraw wallet address
withdrawNetwork	string	withdraw network
withdrawMemo	string	withdraw network memo
withdrawTxHash	string	withdraw tx hash
orderDetailLink	string	order detail link
orderTime	timestamp	order time
completionTime	timestamp	completion time

Response Body

• HTTP status code is 200
• Response body is in JSON format.

Field	Type	Remarks
returnCode	string	SUCCESS or other code you wish to return to Binance Connect
returnMessage	string	the message you wish to return to Binance Connect

How signature works

The webhook signature flow is as follows:

Verify signature

The example code below shows how to verify signature with public key:

public static boolean verify(String srcData, PublicKey publicKey, String sign) throws Exception {
    Signature signature = Signature.getInstance("SHA256withRSA");
    signature.initVerify(publicKey);
    signature.update(srcData.getBytes());
    return signature.verify(Base64.decodeBase64(sign.getBytes()));
}

Example

Request Body:

{
   "externalOrderId": "180401941923045",
   "type": 1,
   "status": 2,
   "payMethodCode": "BUY_P2P",
   "payMethodSubCode": "BANK",
   "fiatCurrency": "EUR",
   "cryptoCurrency": "USDT",
   "fiatAmount": "100",
   "cryptoAmount": "107.8",
   "feeAmount": "1",
   "feeCurrency": "USDT",
   "revenueAmount": "0.08",
   "revenueCurrency": "USDT",
   "networkFee": "0.5",
   "withdrawWalletAddress": "0xbb4CdB98Bd36B01bD1cBaEA52De08d9173bc095c",
   "withdrawNetwork": "BSC",
   "withdrawMemo": "",
   "withdrawTxHash": "0xcb163e2e6322cd6aa7bc4d45306029e846c0c06e9cdee45a06e88801d1231e71",
   "orderDetailLink": "https://www.binance.com/en/my/wallet/exchange/buysell-history?type=buy",
   "orderTime": 1723186761000,
   "completionTime": 1723206761000
}