Profit Sharing

The Profit Sharing Solution allows you to split incoming order payments into your various stakeholders Binance account, all you need is their Binance ID. This will allow you to manage your payment efficiently.

Profit Sharing Use Case

Business Model	Description
Marketplace	With Binance Pay profit sharing, automate the commission payments to your seller, service provider or vendors easily.
SuperApp	Binance Pay Profit Sharing allows you as a SuperApp to disburse payment to drivers, partners and employees without any hassle.
Online Service Provider	Binance Pay profit sharing gives you an exclusive opportunity to earn money based on each transaction.
Real Estate & Insurance	Binance Pay Profit Sharing allows you to automate and manage commission payout to your agents and partners efficiently without any hassle.

Business Model

Marketplace

Description

With Binance Pay profit sharing, automate the commission payments to your seller, service provider or vendors easily.

Business Model

SuperApp

Description

Binance Pay Profit Sharing allows you as a SuperApp to disburse payment to drivers, partners and employees without any hassle.

Business Model

Online Service Provider

Description

Binance Pay profit sharing gives you an exclusive opportunity to earn money based on each transaction.

Business Model

Real Estate & Insurance

Description

Binance Pay Profit Sharing allows you to automate and manage commission payout to your agents and partners efficiently without any hassle.

How it Works

1. Retrieve the stakeholders Binance ID
2. Begin integrating by adding the receiver’s Binance ID in the receiver list via Add Receiver API
3. During order creation, set the profit sharing tag as true
4. Call the Submit Split API to perform the split payment to various stakeholders
5. Stakeholders will receive the fund in their funding wallet accordingly.

Get Started

Add Receiver API

Begin by adding the respective receiver’s Binance ID to the receiver list for you to perform profit sharing with.

End Point

POST /binancepay/openapi/profitsharing/v1/add-receiver

Request Example

For full API specification, please go to API Reference.

Input the receiver’s Binance ID in the account parameter.

{    "account": "123456789"}

You can also manage the receivers list with Query Receiver and Delete Receiver API.

Create Order API Tag

When calling the create order API, set the order tag for profit sharing as true to identify the order you want for profit sharing.

End Point

POST /binancepay/openapi/v2/order

Request Example

For full API specification, please go to API Reference.

Input the receiver’s Binance ID in the account parameter.

{    "env" : {        "terminalType": "APP"     },    "orderTags": {        "ifProfitSharing": true     },    "merchantTradeNo": "9825382937292",    "orderAmount": 25.17,    "currency": "USDT",    "goods" : {        "goodsType": "01",        "goodsCategory": "D000",        "referenceGoodsId": "7876763A3B",        "goodsName": "Ice Cream",        "goodsDetail": "Greentea ice cream cone"     }}

Response Example

{  "status": "SUCCESS",  "code": "000000",  "data": {    "prepayId": "29383937493038367292",    "terminalType": "APP",    "expireTime": 121123232223,    "qrcodeLink": "https://qrservice.dev.com/en/qr/dplkb005181944f84b84aba2430e1177012b.jpg",    "qrContent": "https://qrservice.dev.com/en/qr/dplk12121112b",    "checkoutUrl": "https://pay.binance.com/checkout/dplk12121112b",    "deeplink": "bnc://app.binance.com/payment/secpay/xxxxxx",    "universalUrl": "https://app.binance.com/payment/secpay?_dp=xxx=&linkToken=xxx"  }}

Save the prepayId returned, as this is the unique order identifier from Binance. You will use the prepayId to perform order status query, refund and profit splitting.

Submit Split API

To perform the profit sharing to the receiver added in the list, call the submit split API. Enter the desired amount and receivers’ Binance ID.

End Point

POST /binancepay/openapi/profitsharing/v1/submit-split

Request Example

For full API specification, please go to API Reference.

{    "merchantRequestId": "some_unique_id_1234",    "prepayOrderId": 12345,    "receiverList": [        {            "account": "123456",            "amount": 9.99,            "description": "A description."        }    ]}

Response Example

{  "status": "SUCCESS",  "code": "000000",  "data": {    "splitOrderNo": "12345",    "merchantRequestId": "1234567",    "prepayOrderId": "123456789",    "status": 0,    "receiverOrderDetails": [      {        "account" : "12345678",        "amount": 2.5,        "detailId": 1000001,        "status": 2,        "finishTime": 1679044272      }    ]  }}

You can monitor the split process with the status returned.

Status	Description
Success	The request is successful, the receiver should receive the amount in their funding wallet.
Processing	The request is still in process, please use the query split API for the final result.
Fail	The request is unsuccessful, please refer to the error message for the exact reason

Query Split API

Optional step: You can also get the status of the profit sharing request with the Query Split API.

End Point

POST /binancepay/openapi/profitsharing/v1/query-split

Request Example

For full API specification, please go to API Reference.

{    "merchantRequestId": "my_request_1234",    "prepayOrderId": "123456789"}