Skip to main content

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#

AttributesTypeRequiredLimitationDescription
bizTypestringY-"TECH_PROVIDER"
bizIdlongY-tech provider id
bizIdStrstringY-biz id as string
bizStatusstringY-"SUBMIT_AUTH_AGREE","SUBMIT_AUTH_REJECT","TP_AUTH_CHANGED","TP_AUTH_DISABLED"
datastringY-JSON string, data details refer to

Child Attribute#

Notification Data#

AttributesTypeRequiredLimitationDescription
authorizationIdstringY-authorization Id
authorizationTokenstringY-authorization token
merchantIdlongY-merchant id
merchantNamestringYmaximum length 128merchant name
scopeslist[string]NEnum string listCONVERT: 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#

AttributesTypeRequiredLimitationDescription
returnCodestringY"SUCCESS" or "FAIL"result code of notification processing, if process fail, Binance Pay will retry
returnMessagestringN-return message

Sample Response#

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

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