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: [email protected]
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
Code
AUTH REJECT
Code
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.
Code
Was this page helpful?
Last modified on