How to Amend Binance Pay Sub-Merchant Information

What is a Sub-Merchant?

A Sub-Merchant is a virtual account created under a Channel Partner’s main account to manage acquired merchants or subsidiary companies. Note that a Sub-Merchant account is virtual and cannot be used to log in.

How can I create a Sub-Merchant?

There are two ways to create a Sub-Merchant:

• Via API: Use the Sub-Merchant API to create accounts
• Via Merchant Management Portal (MMP): Create Sub-Merchants directly through the Merchant Dashboard.

What information is required to create a Sub-Merchant?

The following fields are mandatory (as of December 2024) 

• Sub-Merchant Name
• Store Type (0 = Online, 1 = Physical, -1 = Both Online & Physical)
• Merchant Category Code (MCC)
• Business Registration Number
• Business Registration Country
• Betting Operational Certificate or URL (only if MCC = 1024 Betting)
• Site URL (for online stores) and/or Store Address (for physical stores)

Note: Mandatory fields may be updated to comply with regulatory requirements.

After sub-merchant is created successfully, you will see a “subMerchantId” returned. Capture the “subMerchantId” and pass the “subMerchantId” in the Create Order API when creating a new order for your sub-merchant, refer to [How do I use the Sub-Merchant ID when creating orders?] below for more information.

You can manage and view all orders for each Sub-Merchant directly in the Merchant Dashboard and in the exported transaction reports.

If you need to update or change any Sub-Merchant information, you can do so either by using the Modify Sub-Merchant API or manually through the Merchant Dashboard.

Create a Sub-Merchant via API

Send a POST request to the endpoint:

Request Example

• For full API specification, please go to API Request Reference.

Response Example

• For full API specification, please go to API Request Reference.
• Capture subMerchantID and store it in your database. Pass the subMerchantId accordingly when calling the Create Order for the specified sub-merchant

Create a Sub-Merchant via Merchant Management Portal (MMP)

In addition to using the “Create SubMerchant” API, Sub-Merchants can also be created via the Merchant Management Platform (MMP).

Under the [Partner Feature] tab - Sub Merchant Accounts

1. You can choose to enable “Display Sub Merchant Name” feature for both payment and payout
2. Click [Add New Sub Merchant] and fill in the information of your SubMerchant accordingly to create and retrieve the “subMerchantId”

Please note that the “Business Brand Logo” is optional. 

How do I modify Sub-Merchant Information?

You can modify sub-merchant information via API and MMP:

1. Via Sub-merchant API to update submerchant details

Send a POST request to the endpoint:

Request Example

• For full API specification, please go to API Request Reference.

2. Via MMP - Merchant Dashboard, navigate to the [Sub Merchant Accounts] tab. Locate the Sub-Merchant you wish to modify and select “Edit” to update the details accordingly.

Edit and input the information accordingly and scroll to the bottom, select [Confirm] to save it.

How do I use the Sub-Merchant ID when creating orders?

When creating an order via the Create Order API, include the subMerchantId in the request to associate the order with the correct Sub-Merchant.

Request Example

• For full API specification, please go to API Request Reference.