Introduction

This API support Merchant to query sub-merchant.

API Description

Request Method:POST

Request Path:open/api/merchant/query

Parameters

Request parameters

subMerchantNo and externalSubMerchantNo must send one.

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
subMerchantNo	N	Y	string	64	Sub merchant number
externalSubMerchantNo	N	Y	string	32	External sub merchant number

Request Example

{
    "appId": "TEST000001",
    "externalSubMerchantNo": "test_000002",
    "subMerchantNo": "300017425425788420221",
    "sign": "23DCB73176D92B362EF2BA542A75927A684FF83884662D70425BE47C36B996B1CBED22B66689311AE080018BFD77972DF61A199D96BEB0181588E71A29EE46E4"
}

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	Mandatory	Type	Description
externalSubMerchantNo	Y	string	External sub-merchant number
subMerchantNo	Y	string	Sub-merchant number
subMerchantName	N	string	Sub-merchant name
businessType	N	string	1. Online 2. Offline 3. Both
officialWebsiteAddress	N	string	Official website address
companyRegisteredName	N	string	Registered name of the company entity
entityRegistrationNumber	N	string	Registration number of the entity
registrationDate	N	string	Registration date
registeredBusinessAddress	N	string	Registered company address (Country/State/City/Street Address)
email	N	string	Company email address
businessRange	N	string	Business model
slidingPoint	N	double	Slippage percentage
slidingFixedValue	N	double	Fixed slippage value
deductionMethod	N	string	Deduction method: INNER_BUCKLE (internal), OUTER_BUCKLE (external)
payWayCode	N	string	payWayCode
autoWithdrawStatus	N	boolean	Whether auto-withdrawal is enabled
autoWithdrawAmountLimit	N	double	Auto-withdrawal amount (in CNY, up to two decimal places)
bankFormInfo	N	object	Bank withdrawal form information

Response Example

{
    "code": "0",
    "msg": "success",
    "model": {
        "subMerchantNo": "300017425425788420221",
        "externalSubMerchantNo": "test_000002",
        "subMerchantName": "Test Merchant",
        "businessType": "Online",
        "officialWebsiteAddress": "https://testmerchant.com",
        "companyRegisteredName": "Test Company Ltd.",
        "entityRegistrationNumber": "1234567890",
        "registrationDate": "2025-01-01",
        "registeredBusinessAddress": null,
        "email": "[email protected]",
        "businessRange": "E-commerce",
        "slidingPoint": 0.05,
        "slidingFixedValue": 5,
        "deductionMethod": "INNER_BUCKLE",
        "payWayCode": "USDT",
        "autoWithdrawStatus": true,
        "autoWithdrawAmountLimit": 1000,
        "bankFormInfo": {
            "drawNetwork": "TRX",
            "drawAddress": "0xa6459EF31C68DCF46cC603C526526DB1C6eE4fD1"
        }
    },
    "traceId": "67dd3c888702bd21d1f61f946f8a455b",
    "success": true,
    "error": false
}