Tech Service Provider Notification

Webhook Endpoints

Binance Pay will send tech service provider events to partner for notification. You will be able to configure webhook endpoints via the Binance Merchant Admin Portal.

*This is only available for whitelisted merchants. If you need any help, you can contact us: merchant@binance.com

In situation where event was auth agree/reject/changed/disabled, the webhook will retry up to 6 times to resend the event.

Request Parameters

Attributes	Type	Required	Limitation	Description
bizType	string	Y	-	"TECH_PROVIDER"
bizId	long	Y	-	tech provider id
bizIdStr	string	Y	-	biz id as string
bizStatus	string	Y	-	"SUBMIT_AUTH_AGREE","SUBMIT_AUTH_REJECT","TP_AUTH_CHANGED","TP_AUTH_DISABLED"
data	string	Y	-	JSON string, data details refer to

Child Attribute

Notification Data

Attributes	Type	Required	Limitation	Description
authorizationId	string	Y	-	authorization Id
authorizationToken	string	Y	-	authorization token
merchantId	long	Y	-	merchant id
merchantName	string	Y	maximum length 128	merchant name
scopes	list[string]	N	Enum string list	CONVERT: all convert APIs. REFUND: refund order api. CHECKOUT: all order related APIs except refund order api. PAYOUT: all payout related APIs. REPORT: all reporting related APIs. INTERNAL_TRANSFER: all transfer fund related APIs. BALANCE: all wallet balance related APIs.

Sample Payload

AUTH AGREE

{
  "bizType": "TECH_PROVIDER",
  "data": "{\"authorizationId\":\"210462863998500864\",\"authorizationToken\":\"4f92a76767a948d8b5ab60abd8ca2e15\",\"merchantId\":1000135331248,\"merchantName\":\"Test\",\"scopes\":[\"CONVERT\"]}",
  "bizIdStr": "210462863998500864",
  "bizId": 210462863998500864,
  "bizStatus": "SUBMIT_AUTH_AGREE"
}

AUTH REJECT

{
  "bizType": "TECH_PROVIDER",
  "data": "{\"authorizationId\":\"210459190727720960\",\"authorizationToken\":\"ac97fa06614247f0a0d45d50c2cd5937\",\"merchantId\":1000135331248,\"merchantName\":\"Test\",\"scopes\":[\"BALANCE\"]}",
  "bizIdStr": "210459190727720960",
  "bizId": 210459190727720960,
  "bizStatus": "SUBMIT_AUTH_REJECT"
}

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}

Webhook Endpoints​

Request Parameters​

Child Attribute​

Notification Data​

Sample Payload​

AUTH AGREE​

AUTH REJECT​

Response Parameters​

Sample Response​