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.

To learn more about Binance Pay, visit the Binance Pay FAQs page.

Disclaimer: Digital asset prices can be volatile. The value of your investment may go down or up and you may not get back the amount invested. You are solely responsible for your investment decisions and Binance is not liable for any losses you may incur. Please fund your wallet and perform your transactions cautiously. Not financial advice. For more information, see our Terms of Use, Binance Pay Terms of Use and Risk Warning.