微信支付-跨境开发者中心

1. 接口说明

适用对象:机构模式

请求URL: https://apihk.mch.weixin.qq.com/v3/global/merchants/{sub_mchid}

请求方式: GET

Path指该参数为路径参数

Query指该参数为URL参数

Body指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
机构appid	sp_appid	string[1,32]	是	Query机构在微信公众平台申请服务号对应的APPID 注意：仅适用于机构模式示例值：wx8888888888888888
机构商户号	sp_mchid	string[1,32]	是	Query微信支付分配的机构商户号注意：仅适用于机构模式示例值：3200000001
子商户号	sub_mchid	string[1,32]	是	Path子商户号示例值：20000100

请求示例

JSON


https://apihk.mch.weixin.qq.com/v3/global/merchants/{20000100}?sp_appid=wx8888888888888888&sp_mchid=1900000100


{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

子商户号

sub_mchid

string(32)

是

微信支付分配的子商户号
示例值：20000100

子商户全称

name

string(128)

是

子商户公司注册的名称
示例值：Merchant name

子商户简称

shortname

string(64)

是

子商户简称，用于微信订单详情和支付成功页展示
示例值：Merchant shortname

公司联系方式

office_phone

string(32)

是

商户联系方式，用户支付完成后展示给用户的商家联系方式
示例值：075586010000

注册国家或区域

merchant_country_code

string(3)

是

子商户公司注册的国家或区域
示例值：344

类目

business_category

int

是

参考附录，详见商业类目列表
示例值：101

联系人信息

contact

object

是

联系人信息，详细说明见

参数名	变量	类型[长度限制]	必填	描述
联系人名称	name	string[1,64]	是	联系人名称，该字段需进行加密处理，加密方法详见下面说明示例值：李先生
联系人电话	phone	string[1,32]	是	联系人电话，该字段需进行加密处理，加密方法详见下面说明示例值：075586010000
联系人邮箱	email	string[1,256]	是	联系人邮箱，该字段需进行加密处理，加密方法详见下面说明示例值：test@test.com

商户类型

merchant_type

string[1,10]

是

取值ENTERPRISE或INDIVIDUAL
若商户为自然人或独资经营者，请选择INDIVIDUAL。
示例值：ENTERPRISE

公司注册文件编号

registration_certificate_number

string[1,50]

是

公司注册文件编号。
若商户为自然人，请提供董事或负责人的ID号。
若商户为独资经营者，请提供独资经营的业务资质证书编号。
示例值：5555-8888

公司注册文件过期时间

registration_certificate_date

string[1,10]

是

公司注册文件过期时间。
取值为过期的日期或取值为“PERMANENT”，“N/A”, 若取值为日期，格式为YYYY-MM-DD，比如2020-10-16。
若商户为自然人，请提供董事或负责人的ID号过期日期。
若商户为独资经营者，请提供独资经营的业务资质证书编号过期日期。
示例值：2020-10-16

子商户银行结算账户信息

settlement_bank_number

string[1,128]

否

子商户的结算银行账户信息
示例值：555588889999

业务信息

business

object

是

业务信息，具体请参考business对象列表

参数名	变量	类型[长度限制]	必填	描述
业务类型	business_type	string[1,7]	是	业务类型为ONLINE，OFFLINE或BOTH 示例值：BOTH
APP下载链接	app_download	string[1,128]	是/否	商户APP的下载地址，当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：https://download.qq.com
业务网站	website	string[1,128]	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：https://www.qq.com
公众号	office_account	string[1,128]	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：wx8888888888888888
小程序	mini_program	string[1,128]	是/否	当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入示例值：wx8888888888888888
门店地址	store_address	string[1,128]	是/否	商户门店地址，当业务类型取值为OFFLINE或BOTH时必传示例值：10F World Finance Centre (South Office), 11 Canton Road, Tsim Sha Tsui, Hong Kong
MCC码	mcc	string[1,4]	是/否	Mcc码，详见商户行业编码示例值：4214

董事信息

director

object

是/否

董事信息，当商户类型为ENTERPRISE必传，具体请参考director对象列表

参数名	变量	类型[长度限制]	必填	描述
董事姓名	name	string[1,128]	否	董事姓名，当商户类型为ENTERPRISE时选择填入示例值：Bob
董事证件号	number	string[1,128]	否	董事证件号码，当商户类型为ENTERPRISE时选择填入示例值：5555-8888

负责人信息

principal

object

是/否

负责人信息，当商户类型为INDIVIDUAL必传，具体请参考principal对象列表

参数名	变量	类型[长度限制]	必填	描述
负责人姓名	name	string[1,128]	否	负责人姓名，当商户类型为INDIVIDUAL时选择填入示例值：Bob
负责人证件号	number	string[1,128]	否	负责人证件号，当商户类型为INDIVIDUAL时选择填入示例值：5555-8888

H5支付权限详情

h5_payment

object

否

BodyH5支付权限详情

参数名	变量	类型[长度限制]	必填	描述
H5驳回详情	audit_reject_detail	string[1,1024]	否	H5支付权限状态为REJECTED或APPLICATION_FAILED时返回；申请单被驳回的原因或申请失败原因。示例值：商户证书不符合要求
H5支付权限状态	h5_authorization_state	string[1,32]	否	apply_h5_payment为YES时返回，描述子商户的H5支付权限状态： APPROVED：已有H5权限； UNAUTHORIZED：未获得H5权限，也未申请过H5权限； UNDER_REVIEW：H5权限申请当前在审核中； REJECTED：H5权限申请被驳回，请于audit_reject_detail字段查看驳回原因； UNDER_PUNISHMENT：曾经申请并获得H5权限，但当前权限被处罚，请联系BD处理； APPLICATION_FAILED：H5权限申请单创建失败，请于audit_reject_detail字段查看失败原因；示例值：APPROVED

子商户状态信息

sub_merchant_state

object

否

Body子商户状态信息

参数名

变量

类型[长度限制]

必填

描述

子商户状态

sub_merchant_status

string[1,32]

否

子商户状态，表示当前该子商户在微信支付系统内的状态：
OPERATING：正常；子商户权限正常，可发起交易；
PENDING：待处理；子商户资料未通过日常审核，需要机构登录微信支付商户平台查看和处理。子商户权限正常，可发起交易；
DEACTIVATED：已停用；该子商户被机构自主停用，无支付权限，不能发起交易
CLOSED：已关闭；该子商户被微信支付关闭支付权限，不能发起交易；
INCOMPLETE_APPLICATION：未完成入驻；子商户入驻申请未完成，无支付权限，不能发起交易。请于application_status字段查看入驻申请状态
示例值：OPERATING

子商户入驻状态

application_status

string[1,32]

否

子商户状态为:
INCOMPLETE_APPLICATION时返回；子商户入驻申请状态：
UNDER_REVIEW：审核中；微信支付正在审核该子商户的入驻申请，请耐心等待；建议每隔一天查询一次子商户状态，直至子商户流转到其他状态；
REJECTED：已驳回；该子商户的入驻申请被微信支付驳回，请于application_rejected_detail字段查看驳回原因
示例值：UNDER_REVIEW

子商户入驻驳回详情

application_reject_detail

object

否

Body子商户入驻状态为REJECTED时返回；入驻申请被微信支付的审核人员驳回的原因；以json array形式展示每个驳回字段及对应驳回原因
如申请被驳回，请登录微信支付商户平台，按要求修改申请信息后重新提交（暂不支持API）

参数名	变量	类型[长度限制]	必填	描述
驳回字段	field	string[1,128]	否	子商户入驻申请单中被微信支付的审核人员驳回的字段名称示例值：name
驳回原因	reason	string[1,1024]	否	子商户入驻申请单中微信支付的审核人员驳回该字段的原因示例值：Merchant name is invalid.

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

参数名	变量	类型[长度限制]	必填	描述
指示错误参数的位置	field	string[1, 256]	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer 当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string[1, 256]	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string[1, 256]	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string[1, 256]	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

返回示例

子商户状态为OPERATING 子商户状态为INCOMPLETE_APPLICATION

{
  "sub_mchid": "20000100",
  "name": "test mcherchan_name",
  "shortname": "mcherchan_name",
  "office_phone": "075586010000",
  "merchant_introduction": "hotel and restaurant",
  "business_category": 644,
  "contact": {
    "name": "Bob Zhang",
    "phone": "+8613633334444"
  },
  "principal": {
    "principal_name": "Bob",
    "principal_id_number": "5555-8888"
  },
  "h5_payment": {
    "h5_authorization_state": "APPROVED"
  },
  "sub_merchant_state": {
      "sub_merchant_status": "OPERATING"
  }
}

{
  "sub_mchid": "20000100",
  "name": "test mcherchan_name",
  "shortname": "mcherchan_name",
  "office_phone": "075586010000",
  "merchant_introduction": "hotel and restaurant",
  "business_category": 644,
  "contact": {
    "name": "Bob Zhang",
    "phone": "+8613633334444"
  },
  "principal": {
    "principal_name": "Bob",
    "principal_id_number": "5555-8888"
  },
  "h5_payment": {
    "h5_authorization_state": "UNDER_REVIEW"
  },
  "sub_merchant_state": {
    "application_reject_detail": [
      { "field": "name", "reason": "Merchant name is invalid." }
    ],
    "application_status": "REJECTED",
    "sub_merchant_status": "INCOMPLETE_APPLICATION"
  }
}

4. 错误码

错误码	描述	解决方案
PARAM_ERROR	请求参数未按指引进行填写	具体参数格式可以查看文档
INVALID_REQUEST	商户系统异常导致，商户权限异常、重复请求支付、证书错误、频率限制、商户号不存在、appid和mchid不存在绑定关系、渠道号不对等	请根据接口返回的详细错误描述信息检查您的程序
SYSTEM_ERROR	后台系统返回错误	系统异常，请使用原参数重新发起

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

查询子商户API

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

正常返回

异常返回

返回示例

4. 错误码