Share Account Id Notification
Webhook Endpoints#
Binance Pay will send share account id events to partner for notification. You will be able to configure webhook endpoints via the Binance Merchant Admin Portal.
In situation where event is user agrees to share account id, the webhook will retry up to 6 times to resend the event.
Request Parameters#
| Attributes | Type | Required | Limitation | Description |
|---|---|---|---|---|
| bizType | string | Y | - | "SHARE_ACCOUNT_ID" |
| bizId | long | Y | - | id |
| bizIdStr | string | Y | - | biz id as string |
| bizStatus | string | Y | - | "SUCCESS" |
| data | string | Y | - | JSON string, data details refer to |
Child Attribute#
Notification Data#
| Attributes | Type | Required | Limitation | Description |
|---|---|---|---|---|
| requestId | string | Y | letter or digit, no other symbol allowed, maximum length 32 | The unique ID assigned by the merchant to identify a share account id request. |
| userBinanceId | string | Y | maximum length 19 | user binance id |
| userName | string | N | - | user nickname, nullable |
Sample Payload#
userName is not null#
userName is null#
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.