二级商户入驻
二级商户的入驻流程如下图所示：
图 1. 二级商户入驻流程
- 二级商户向平台商提供入驻材料。
- 平台商通过调用 二级商户入驻 接口提交相关材料来帮助二级商户入驻 Antom。
- Antom 向平台商返回入驻申请结果。
- 平台商反馈二级商户入驻申请结果。
- 平台商提交二级商户入驻材料后，Antom 会进入材料审核流程，通常审核时间为 4 到 17 天。
- 材料审核完成后，Antom 会通过发送异步通知来告知平台商二级商户入驻结果。
- 平台商告知二级商户入驻结果。
入驻申请
平台商通过调用 二级商户入驻 接口来申请二级商户的入驻，二级商户入驻申请需要提供以下材料：
- 结算信息：二级商户的结算银行账户等结算相关信息。
- 商户标识：二级商户的主体相关信息。
- 主体信息：二级商户的主体信息及关联信息。
- 业务信息：二级商户展业的网站，售卖的商品类型等业务相关信息。
结算信息
在接口请求中，平台商需要传入结算银行账号、账号支持者等相关结算银行账号信息（settlementBankAccount），及该结算银行账号所对应的结算币种（settlementCurrency）。
{
"//": "...",
"settlementInfos": [
{
"settlementBankAccount": {
"bankRegion": "BR",
"bankAccountNo": "1234567",
"swiftCode": "AAAAAABRAAA",
"accountHolderName": "Timi",
"routingNumber": "123",
"bankBranchCode": "0001",
"cardTIN": "1234567****",
"depositType": "CC",
"accountHolderType": "ENTERPRISE"
},
"settlementCurrency": "USD"
}
],
"//": "...",
}商户标识
在商户信息（merchantInfo）中，平台商需要定义该二级商户的 referenceMerchantId，该二级商户 ID 后续会在支付和结算请求中使用。loginId 后续将作为该二级商户的 Antom 账号注册邮箱，二级商户可以使用该邮箱登录 Antom 商家门户后台。
商户信息下的 legalEntityType 表示该二级商户的主体类型，目前只支持公司类型的主体进行入驻。
{
"//": "...",
"merchantInfo": {
"loginId": "a_cangxi_lj_20230611_205925_260@test****",
"legalEntityType": "COMPANY",
"company": "...",
"entityAssociations": "...",
"businessInfo": "...",
"referenceMerchantId": "mid_cangxi_lj_20230611_205925****"
}
}主体信息
若二级商户的主体类型为公司，则平台商需要在入驻请求中通过参数 merchantInfo.company 上送公司信息，同时通过参数 merchantInfo.entityAssociations上送其关联信息。
在二级商户的公司信息中，平台商需要通过 merchantInfo.company.attachments 上送公司章程，和授权签字人确认函，并在 fileUrl 中上送对应的文件下载地址。若二级商户公司已上市，平台需要通过参数 stockInfo 上送其上市信息。
Antom 对二级商户关联实体的定义为法定代表人和股东两类，平台在请求中需要两类信息都上传。对于股东，平台需要通过参数 shareholdingRatio 上送其持股比例。
{
"//": "...",
"merchantInfo": {
"loginId": "20230706_212932_137@test****",
"legalEntityType": "COMPANY",
"company": {
"legalName": "Tom and Jerry",
"registeredAddress": {
"region": "BR"
},
"attachments": [
{
"attachmentType": "SIGNATURE_AUTHORIZATION_LETTER",
"fileUrl": "https://img.alicdn.com/tps/TB1h9xxIFXXXXbKXXXXXXXXXXXX.jpg"
},
{
"attachmentType": "ARTICLES_OF_ASSOCIATION",
"fileUrl": "https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg"
}
],
"certificates": [
{
"certificateNo": "cnpj12****",
"certificateType": "CNPJ"
}
],
"companyType": "LTDA",
"incorporationDate": "2022-02-02",
"operatingAddress": {
"region": "BR"
}
},
"entityAssociations": [
{
"individual": {
"legalName": "Tom",
"certificates": [
{
"fileUrls": [
"https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg"
],
"certificateNo": "cpf12****",
"certificateType": "CPF"
}
],
"dateOfBirth": "1995-04-13"
},
"associationType": "LEGAL_REPRESENTATIVE",
"legalEntityType": "INDIVIDUAL"
},
{
"individual": {
"legalName": "Jerry",
"certificates": [
{
"certificateNo": "cpf12****",
"certificateType": "CPF"
}
],
"dateOfBirth": "1995-03-14"
},
"shareholdingRatio": "23.33",
"associationType": "UBO",
"legalEntityType": "INDIVIDUAL"
},
{
"//": "..."
}
]
}
}业务信息
平台需要通过 businessInfo 上送该二级商户的业务信息，包括在哪个网站上展业，以及其业务类型 MCC。
MCC 列表请参考 MCC list。
{
"//":"...",
"merchantInfo": {
"//":"...",
"businessInfo": {
"websites": [
{
"name": "homepage",
"description": "company's homepage url",
"url": "https://taobao.com"
}
],
"mcc": "5021"
},
"//":"..."
}
}入驻申请结果
平台提交二级商户入驻请求之后，Antom 将返回该请求的提交结果，样例如下：
{
"result": {
"resultStatus": "S",
"resultCode": "SUCCESS",
"resultMessage": "success."
},
"registrationStatus": "PROCESSING"
}其中若 resultStatus 为 S 则表示入驻请求提交成功，为F时表示入驻提交失败，Antom 会通过 resultMessage 表示失败的原因。该接口通过 registrationStatus 字段返回的二级商户的入驻情况会固定为 PROCESSING，因为入驻申请成功后，Antom 需要对入驻资料进行审核，因此入驻结果不会立即返回。
获取入驻结果通知
在入驻请求提交之后，Antom 会对请求中提交材料进行审核，在审核完成后 Antom 会通过 入驻结果通知 异步通知接口通知平台商二级商户入驻的结果。
异步通知的地址需要平台商在开发者中心进行设定。在 Antom Dashboard 的 Integration Settings 标签页下，编辑 Notification URL。
入驻成功的异步通知样例如下：
{
"notifyType": "REGISTRATION_RESULT",
"referenceMerchantId": "MERCHANT_2023061813584****",
"registrationRequestId":"REQUEST_2023061813584****",
"registrationStatus":"SUCCESS"
}若入驻失败，在异步通知中，会通过 reasonCode、reasonMessage 告知入驻失败的原因，平台商可以根据原因提示更改信息后重新发起入驻请求。若入驻失败，loginId 和 referenceMerchantId 将不会被占用，可以复用，但 registrationRequestId 需要更换。
入驻失败的异步通知样例如下：
{
"notifyType": "REGISTRATION_RESULT",
"referenceMerchantId": "MERCHANT_2023061813584****",
"registrationRequestId": "REQUEST_2023061813584****",
"registrationStatus": "FAIL",
"reasonCode": "MISSING_OR_INCORRECT_INFO",
"reasonMessage": "The registration information is incomplete or incorrect. Use a new registrationRequestId to call the register API again."
}收到 Antom 的异步通知后，需要您按照如下规定格式返回响应。若未按要求响应异步通知，或者因为网络原因异步通知未送达，通知会在 24 小时内自动重发。通知至多重发 8 次或直至收到正确响应终止发送。发送间隔如下：0分钟，2分钟，10分钟，10分钟，1小时，2小时，6小时，15小时。
{
"result": {
"resultStatus": "S",
"resultCode": "SUCCESS",
"resultMessage": "success."
}
}更多参考
若二级商户的结算银行账户信息发生变更，平台商可以帮助二级商户通过接口提交变更请求。关于如何更换二级商户结算信息，请参考 更换结算信息。