Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

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

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

网关URL

您可使用支付宝沙箱进行集成测试,详情请参考sandbox handbook

Note:

如果您使用的是POST方法, 需在请求URL当中标明_input_charset的编码格式。例如,https://mapi.alipaydev.com/gateway.do?_input_charset=UTF-8

请求参数

参数类型(字节长度)描述可选示例

基本参数

serviceString接口名称不可空alipay.overseas.secmerchant.maintain.queryStatus
partnerString(16)合作者身份ID。签约的支付宝账号对应的支付宝唯一用户号。 以2088开头的16位纯数字组成。不可空2088101142878662
_input_charsetString参数编码字符集。商户网站使用的编码格式,如utf-8、gbk、gb2312等。不可空gbk
sign_typeString签名方式。RSA、RSA2、MD5三个值可选,必须大写。不可空MD5
signString签名不可空2118ac8fad6bc1d9e88a6cd017c18d37
timestampString时间戳。接口的调用时间,支付宝会在一定时间内失效此调用(默认半小时)。此时间目前以北京时间为准,格式为 :yyyy-MM-dd HH:mm:ss。不可空2019-02-01 08:30:10
业务参数
secondary_merchant_idString(64)二级间连商户ID,相同PID下二级间连商户ID需唯一。不可空MERCHANT_ID_0003
payment_methodString二级商户类型,对于线上商户,此字段值为ONLINE_PAYMENT。不可空ONLINE_PAYMENT

同步返回

响应将以XML格式返回。

参数类型(字节长度)描述可选示例
signString签名可空744a87f0e3b40e6a8cd8f9705ce61511
sign_typeString签名方式,RSA、RSA2、MD5三个值可选,必须大写。可空MD5
secondary_merchant_idString二级间连商户ID,相同PID下二级间连商户ID需唯一。不可空MERCHANT_ID_0003
reject_reasonString商户未能成功报备的原因。当报备状态为FAILED时,本字段不可空。可空高风险商户,报备被拒绝。
payment_methodString二级商户支付方式,同ONLINE_PAYMENT的值可空ONLINE_PAYMENT
secondary_merchant_nameString(64)

二级商户的法定注册名称,该名称会出现在钱包和对账文件当中,用来识别二级商户。备注:如果二级商户类型是个人(INDIVIDUAL),请填写该负责人的法定全名于本字段。

不可空

Alipay (China) Network Technology Co., Ltd

secondary_merchant_typeString

二级商户类型:

  • 若二级商户为个体户,字段值为INDIVIDUAL。
  • 若二级商户为企业、公司、信托或非盈利组织等,字段值为ENTERPRISE。
不可空INDIVIDUAL
secondary_merchant_industryString(4)

行业类型,用于区分不同行业。详情请参见 MCC list

不可空
registration_noString(128)

企业注册号

备注: 若二级商户类型为个人(INDIVIDUAL)且无注册号,本字段可为空。

可空012345678
register_countryString(2)

注册国家,由ISO3166二位字母编码表示。请参见 ISO 3166

不可空HK
register_addressString(256)

二级商户注册地址。务必使用邮寄地址形式。

不可空No.278, Road YinCheng, Shanghai, China
shareholder_nameString(128)二级商户主要股东的法定全名。本字段仅在二级商户类型为ENTERPRISE时,才需填写。可空Jack Li (股东为个人), Alipay.com Co.,Ltd (股东为企业)
shareholder_idString(128)二级商户主要股东的身份证件号、护照号、或企业注册号码。本字段仅在二级商户类型为ENTERPRISE时,才需填写。可空G53453888 (股东为个人), 012345678 (股东为企业)
representative_nameString(128)负责人法定全名。仅当二级商户类型为INDIVIDUAL时,本字段为必填;如果二级商户类型为ENTERPRISE, 本字段可为空。可空Tom Li
settlement_noString(64)二级商户结算卡银行卡号,仅支持字母和数字。可空2600100000
contact_noString(64)二级商户的联系人电话, 仅支持数字和+-()等特殊字符。可空+86139xxxx7893
contact_emailString(128)二级商户的联系人邮箱可空tomli@gmail.com
cs_noString(64)二级商户的客服电话,仅支持数字和+-()等特殊字符。可空0213355xxx89
cs_emailString(128)二级商户的客服邮箱可空customerservice@xxxcompany.com
site_infosString

商户网址名称,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"}]

statusString二级商户报备状态,如果二级商户报备成功,本字段为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>