境外二级线上商户报备状态查询
境外二级线上商户报备状态查询接口用于查询二级商户的报备状态。
网关URL
| 环境 | HTTPS request URL |
| 生产环境 | https://intlmapi.alipay.com/gateway.do |
| 测试环境 | https://mapi.alipaydev.com/gateway.do |
您可使用支付宝沙箱进行集成测试，详情请参考sandbox handbook。
Note:
如果您使用的是POST方法, 需在请求URL当中标明_input_charset的编码格式。例如，https://mapi.alipaydev.com/gateway.do?_input_charset=UTF-8
请求参数
| 参数 | 类型（字节长度） | 描述 | 可选 | 示例 |
基本参数 | ||||
| service | String | 接口名称 | 不可空 | alipay.overseas.secmerchant.maintain.queryStatus |
| partner | String(16) | 合作者身份ID。签约的支付宝账号对应的支付宝唯一用户号。 以2088开头的16位纯数字组成。 | 不可空 | 2088101142878662 |
| _input_charset | String | 参数编码字符集。商户网站使用的编码格式，如utf-8、gbk、gb2312等。 | 不可空 | gbk |
| sign_type | String | 签名方式。RSA、RSA2、MD5三个值可选，必须大写。 | 不可空 | MD5 |
| sign | String | 签名 | 不可空 | 2118ac8fad6bc1d9e88a6cd017c18d37 |
| timestamp | String | 时间戳。接口的调用时间，支付宝会在一定时间内失效此调用（默认半小时）。此时间目前以北京时间为准，格式为 ：yyyy-MM-dd HH:mm:ss。 | 不可空 | 2019-02-01 08:30:10 |
| 业务参数 | ||||
| secondary_merchant_id | String(64) | 二级间连商户ID，相同PID下二级间连商户ID需唯一。 | 不可空 | MERCHANT_ID_0003 |
| payment_method | String | 二级商户类型，对于线上商户，此字段值为ONLINE_PAYMENT。 | 不可空 | ONLINE_PAYMENT |
同步返回
响应将以XML格式返回。
| 参数 | 类型（字节长度） | 描述 | 可选 | 示例 |
| sign | String | 签名 | 可空 | 744a87f0e3b40e6a8cd8f9705ce61511 |
| sign_type | String | 签名方式，RSA、RSA2、MD5三个值可选，必须大写。 | 可空 | MD5 |
| secondary_merchant_id | String | 二级间连商户ID，相同PID下二级间连商户ID需唯一。 | 不可空 | MERCHANT_ID_0003 |
| reject_reason | String | 商户未能成功报备的原因。当报备状态为FAILED时，本字段不可空。 | 可空 | 高风险商户，报备被拒绝。 |
| payment_method | String | 二级商户支付方式，同ONLINE_PAYMENT的值 | 可空 | ONLINE_PAYMENT |
| secondary_merchant_name | String(64) | 二级商户的法定注册名称，该名称会出现在钱包和对账文件当中，用来识别二级商户。备注：如果二级商户类型是个人（INDIVIDUAL），请填写该负责人的法定全名于本字段。 | 不可空 | Alipay (China) Network Technology Co., Ltd |
| secondary_merchant_type | String | 二级商户类型：
| 不可空 | INDIVIDUAL |
| secondary_merchant_industry | String(4) | 行业类型，用于区分不同行业。详情请参见 MCC list。 | 不可空 | |
| registration_no | String(128) | 企业注册号 备注: 若二级商户类型为个人(INDIVIDUAL)且无注册号，本字段可为空。 | 可空 | 012345678 |
| register_country | String(2) | 注册国家，由ISO3166二位字母编码表示。请参见 ISO 3166。 | 不可空 | HK |
| register_address | String(256) | 二级商户注册地址。务必使用邮寄地址形式。 | 不可空 | No.278, Road YinCheng, Shanghai, China |
| shareholder_name | String(128) | 二级商户主要股东的法定全名。本字段仅在二级商户类型为ENTERPRISE时，才需填写。 | 可空 | Jack Li (股东为个人), Alipay.com Co.,Ltd (股东为企业) |
| shareholder_id | String(128) | 二级商户主要股东的身份证件号、护照号、或企业注册号码。本字段仅在二级商户类型为ENTERPRISE时，才需填写。 | 可空 | G53453888 (股东为个人), 012345678 (股东为企业) |
| representative_name | String(128) | 负责人法定全名。仅当二级商户类型为INDIVIDUAL时，本字段为必填；如果二级商户类型为ENTERPRISE, 本字段可为空。 | 可空 | Tom Li |
| settlement_no | String(64) | 二级商户结算卡银行卡号，仅支持字母和数字。 | 可空 | 2600100000 |
| contact_no | String(64) | 二级商户的联系人电话, 仅支持数字和+-()等特殊字符。 | 可空 | +86139xxxx7893 |
| contact_email | String(128) | 二级商户的联系人邮箱 | 可空 | tomli@gmail.com |
| cs_no | String(64) | 二级商户的客服电话，仅支持数字和+-()等特殊字符。 | 可空 | 0213355xxx89 |
| cs_email | String(128) | 二级商户的客服邮箱 | 可空 | customerservice@xxxcompany.com |
| site_infos | String | 商户网址名称，json格式，最长5个网站或app url。详见 site_infos。 添加或删除URL，请重新传入此参数。 | 不可空 | 二级商户网站或APP URL，格式： [{"site_type":"WEB","site_url":"https://alipay.com","site_name":"w ebsit"}, {"site_type":"APP","site_url":"https://alipay.com","site_name":"we bsit"}] |
| status | String | 二级商户报备状态，如果二级商户报备成功，本字段为SUCCESS; 如果二级商户报备仍在处理中，本字段为UNDER_REVIEW; 如果二级商户报备失败，本字段为FAILED。 | 不可空 | SUCCESS |
业务错误码
| 错误代码 | 描述 | 解决方案 |
| PARAM_ILLEGAL | 参数校验错误，必填参数未填或者输入的参数不正确。 | 输入正确参数并重新发送请求。 |
| DATA_NOT_EXIST | 查询的二级商户数据不存在因为商户未报备。 | 向支付宝系统报备该二级商户之后，再进行报备状态查询。 |
| SYSTEM_ERROR | 未知系统错误。 | 请稍后再试。 |
返回示例
业务正常受理并查询结果正常返回：
copy
<?xml version="1.0" encoding="utf-8"?>
<alipay>
<is_success>T</is_success>
<request>
<param name="service">alipay.overseas.secmerchant.maintain.queryStatus</param>
<param name="partner">2088101131367863</param>
<param name=“_input_charset”>gbk</param>
<param name="sign_type">MD5</param>
<param name="sign">2118ac8fad6bc1d9e88a6cd017c18d37</param>
<param name="timestamp">2019-02-01 08:30:10</param>
<param name="secondary_merchant_id">MERCHANT_ID_0003</param>
<param name="payment_method">ONLINE_PAYMENT</param>
</request>
<response>
<alipay>
<secondary_merchant_id>MERCHANT_ID_0003</secondary_merchant_id>
<status>UNDER_REVIEW</status>
</alipay>
</response>
<sign>744a87f0e3b40e6a8cd8f9705ce61511</sign>
<sign_type>MD5</sign_type>
</alipay>未能获取查询结果:
copy
<?xml version="1.0" encoding="utf-8"?>
<alipay>
<is_success>F</is_success>
<error>DATA_NOT_EXIST</error>
<sign>744a87f0e3b40e6a8cd8f9705ce61511</sign>
<sign_type>MD5</sign_type>
</alipay>