境外二级线上商户报备状态查询

2020-10-17 11:54

境外二级线上商户报备状态查询接口用于查询二级商户的报备状态。

#网关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	签名方式。DSA、RSA、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	签名方式，DSA、RSA、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。若二级商户为企业、公司、信托或非盈利组织等，字段值为ENTERPRISE。	不可空	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>