Introduction

This API support Merchant batch create sub-merchant account.

API Description

Request Method:POST

Request Path:open/api/merchant/batchCreate

Parameters

Request parameters

Parameter	Mandatory	Sign	Type	Length	Remarks
appId	Y	Y	string	64	AppId is unique for merchant
sign	Y	Y	string	128	Sign Check on About the sign
batchMerchantInfoArrayBody	Y	Y	string	--	Sub-Merchant Batch Information Message (Array-Structured String)

Batch Merchant Information

Parameter	Mandatory	Signature Required	Type	Length	Description
externalSubMerchantNo	Y	Y	string	32	External Sub-Merchant Number
subMerchantName	Y	Y	string	32	Sub-Merchant Name
businessType	Y	Y	string	12	Online 2. Offline 3. Both
officialWebsiteAddress	N	Y	string	64	Official Website URL
companyRegisteredName	Y	Y	string	64	Full Registered Name of the Company Entity
entityRegistrationNumber	Y	Y	string	32	Entity Registration Number
registrationDate	Y	Y	string	32	Registration Date (Format: YYYY-MM-DD)
registeredBusinessAddress	Y	Y	string	128	Registered Business Address (Country/State/City/Detailed Address)
email	Y	Y	string	32	Business Email
businessRange	N	Y	string	32	Business Scope
slidingPoint	N	Y	double	10,8	Sliding Point Percentage (e.g., 0.01 = 1%)
slidingFixedValue	N	Y	double	10,8	Sliding Fixed Value (1 in USDT means 1 USDT)
deductionMethod	Y	Y	string	16	Deduction Method: INNER_BUCKLE (internal), OUTER_BUCKLE (external)
payWayCode	Y	Y	string	12	Fiat Currency Unit (`USD_94438`, `USD_94439`, `EUR`, `HKD`) or Digital Currency Unit (`USDT`) USD_94438: Local transfer via the U.S. domestic ACH system USD_94439: International transfer via the SWIFT system
autoWithdrawStatus	N	Y	boolean	1	Enable Auto Withdrawal or Not
autoWithdrawAmountLimit	N	Y	double	20	Auto Withdrawal Amount Limit (Unit: Yuan, up to 2 decimal places)
bankFormInfo	Y	Y	object	1024	Payout Bank Information

Request Example

{
    "appId": "YOUR_APP_ID",
    "sign": "YOUR_SIGN",
    "batchMerchantInfoArrayBody": "[\n  {\n    \"externalSubMerchantNo\": \"TEST000001\",\n    \"subMerchantName\": \"Test Merchant\",\n    \"businessType\": \"Online\",\n    \"officialWebsiteAddress\": \"https://testmerchant.com\",\n    \"companyRegisteredName\": \"Test Company Ltd.\",\n    \"entityRegistrationNumber\": \"1234567890\",\n    \"registrationDate\": \"2025-01-01\",\n    \"registeredBusinessAddress\": \"China/Beijing/Street 123\",\n    \"email\": \"[email protected]\",\n    \"businessRange\": \"E-commerce\",\n    \"slidingPoint\": 0.05,\n    \"slidingFixedValue\": 5,\n    \"deductionMethod\": \"INNER_BUCKLE\",\n    \"payWayCode\": \"HKD\",\n    \"autoWithdrawStatus\": true,\n    \"autoWithdrawAmountLimit\": 1000,\n    \"bankFormInfo\": {\n      \"registeredName\": \"Standard Chartered \",\n      \"country\": \"HK \",\n      \"address\": \"Hong Kong Standard Chartered Bank (Hong Kong) Limited \",\n      \"msisdn\": \"8615588888888\",\n      \"email\": \"[email protected] \",\n      \"locationId\": \"2538\",\n      \"accountNo\": \"App \",\n      \"bankBranchCode\": \"123123\",\n      \"bankName\": \"4172\"\n    }\n  },\n  {\n    \"externalSubMerchantNo\": \"TEST000002\",\n    \"subMerchantName\": \"Test Merchant\",\n    \"businessType\": \"Online\",\n    \"officialWebsiteAddress\": \"https://testmerchant.com\",\n    \"companyRegisteredName\": \"Test Company Ltd.\",\n    \"entityRegistrationNumber\": \"1234567890\",\n    \"registrationDate\": \"2025-01-01\",\n    \"registeredBusinessAddress\": \"China/Beijing/Street 123\",\n    \"email\": \"[email protected]\",\n    \"businessRange\": \"E-commerce\",\n    \"slidingPoint\": 0.05,\n    \"slidingFixedValue\": 5,\n    \"deductionMethod\": \"INNER_BUCKLE\",\n    \"payWayCode\": \"USDT\",\n    \"autoWithdrawStatus\": true,\n    \"autoWithdrawAmountLimit\": 1000,\n    \"bankFormInfo\": {\n      \"drawNetwork\": \"TRX\",\n      \"drawAddress\": \"0xa6459EF31C68DCF46cC603C526526DB1C6eE4fD1\"\n    }\n  }\n]\n"
}

Description of Response Parameters

Parameter	Type	Details
success	boolean	Success
error	boolean	Error
code	long	Response code
msg	string	Response message
traceId	string	Trace id
model	object	Response details

Description of Model Parameters

Parameter	Type	Description
externalSubMerchantNo	string	External Merchant Number
merchantNo	string	Sub-Merchant Number
merchantName	string	Sub-Merchant Name

Response Example

{
    "code":"0",
    "msg":"success",
    "model":[
        {
            "merchantNo":"300017429793729850236",
            "externalSubMerchantNo":"QFTEST",
            "merchantName":"Test Merchant"
        }
    ],
    "traceId":"67e3c12cb7718eb1dccd0af4f3310a0d",
    "success":true,
    "error":false
}