Binance Pay: Order Notification

Webhook Endpoints#

Binance Pay will send order events with final status to partner for notification. You will be able to configure webhook endpoints via the Binance Merchant Admin Portal. Result of the orders that are close will be notified to you through this webhook with bizStatus = "PAY_CLOSED".*

*In the event you did not receive "PAY_CLOSED" notification, please contact us: merchant@binance.com

In situation where event was failed to send, the webhook will retry up to 6 times to resend the event.

Request Parameters#

Attributes	Type	Required	Limitation	Description
bizType	string	Y	-	"PAY"
bizId	long	Y	-	Prepay order id
bizIdStr	string	Y	-	biz id as string
bizStatus	string	Y	-	"PAY_SUCCESS","PAY_CLOSED"
data	string	Y	-	JSON string, data details refer to

Child Attribute#

Notification Data#

Attributes	Type	Required	Limitation	Description
merchantTradeNo	string	Y	letter or digit, no other symbol allowed	The order id, Unique identifier for the request
productType	string	Y	maximum length 16	product type
productName	string	Y	maximum length 256	product name
transactTime	long	Y	-	transaction time
tradeType	string	Y	"WEB", "APP", "WAP", "MINI_PROGRAM", "PAYMENT_LINK", "OTHERS"	operate entrance
totalFee	decimal	Y	-	order amount
currency	string	Y	-	order currency
transactionId	string	N	-	debit transaction id
openUserId	string	N	-	payer unique id
passThroughInfo	string	N	-	pass through info, from the create order api
commission	decimal	Y	-	Transaction fees charged. Please refer to your contract for more info
paymentInfo	object	N	-	payment information, refer to

PaymentInfo Data#

Attributes	Type	Required	Limitation	Description
payerId	long	Y	-	payer pay id
payMethod	string	Y	-	pay method
paymentInstructions	list[PaymentInstruction]	Y	-	payment instruction list, refer to
channel	string	N	-	channel
subChannel	string	N	-	sub channel

PaymentInstruction Data#

Attributes	Type	Required	Limitation	Description
currency	string	Y	-	payment currency
amount	decimal	Y	-	currency amount
price	decimal	Y	-	currency price

Sample Payload#

PAY SUCCESS#

{  "bizType": "PAY",  "data": "{\"merchantTradeNo\":\"xr6wYe8ATWE6thS5Sc7ezMihMFGKn6\",\"productType\":\"Food\",\"productName\":\"Ice Cream\",\"transactTime\":1619508939664,\"tradeType\":\"APP\",\"totalFee\":0.88000000,\"currency\":\"USDT\",\"transactionId\":\"M_R_282737362839373\",\"openUserId\":\"1211HS10K81f4273ac031\",\"commission\":0.0088,\"paymentInfo\":{\"payerId\":1000013312869,\"payMethod\":\"funding\",\"paymentInstructions\":[{\"currency\":\"USDT\",\"amount\":0.88000000,\"price\":1}],\"channel\":\"DEFAULT\"}}",  "bizIdStr": "29383937493038367292",  "bizId": 29383937493038367292,  "bizStatus": "PAY_SUCCESS"}

PAY FAIL#

{  "bizType": "PAY",  "data": "{\"merchantTradeNo\":\"9825382937292\",\"totalFee\":0.88000000,\"transactTime\":1619508939664,\"currency\":\"USDT\",\"openUserId\":\"1211HS10K81f4273ac031\",\"productType\":\"Food\",\"productName\":\"Ice Cream\",\"tradeType\":\"WEB\"}",  "bizIdStr": "29383937493038367292",  "bizId": 29383937493038367292,  "bizStatus": "PAY_FAIL"}

Response Parameters#

Attributes	Type	Required	Limitation	Description
returnCode	string	Y	"SUCCESS" or "FAIL"	result code of notification processing, if process fail, Binance Pay will retry
returnMessage	string	N	-	return message

Sample Response#

After receiving a webhook with your endpoint, please respond with an HTTP 200 OK.

{"returnCode":"SUCCESS","returnMessage":null}