适用对象:机构模式
请求URL: https://api.mch.weixin.qq.com/hk/v3/merchants/{sub_mchid}
请求方式: GET
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3
是否需要证书: 是
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 机构appid | sp_appid | string(32) | 是 | query 机构在微信公众平台申请服务号对应的APPID 注意：仅适用于机构模式 示例值：wx8888888888888888 |
| 机构商户号 | sp_mchid | string(32) | 是 | query 微信支付分配的机构商户号 注意：仅适用于机构模式 示例值：3200000001 |
| 子商户号 | sub_mchid | string(32) | 是 | path 子商户号 示例值：20000100 |
https://api.mch.weixin.qq.com/hk/v3/merchants/{20000100}?sp_appid=wx8888888888888888&sp_mchid=1900000100
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 子商户号 | 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 | 否 | 联系人信息，详见对象说明 |
| 商户类型 | merchant_type | string(10) | 否 | 取值ENTERPRISE或INDIVIDUAL 示例值：ENTERPRISE |
| 公司注册文件编号 | registration_certificate_number | string(50) | 否 | 公司注册文件编号，当商户类型取值为ENTERPRISE时必填 示例值：5555-8888 |
| 公司注册文件过期时间 | registration_certificate_date | string(10) | 否 | 公司注册文件过期时间。取值为过期的日期或取值为“PERMANENT” , “N/A”, 若取值为日期，格式为YYYY-MM-DD，比如2020-10-16。当商户类型为ENTERPRISE时必填。 示例值：2020-10-16 |
| 子商户结算账户 | settlement_bank_number | string(128) | 否 | 子商户结算账户信息 示例值：555588889999 |
| + 业务信息 | business | object | 否 | 参考对象说明 |
| + 董事信息 | director | object | 否 | 董事信息，参考对象说明 |
| + 负责人信息 | principal | object | 否 | 负责人信息，当商户类型为INDIVIDUAL必传，具体请参考principal对象列表 |
| 参数名 | 变量 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回状态码 | code | string(32) | 是 | 错误码，枚举值见错误码列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string(256) | 是 | 返回信息，如非空，为错误原因 示例值：参数格式校验错误 |
| + 详细的错误描述 | detail | object | 否 | 当code为PARAM_ERROR时返回，详细说明见下 |
{
"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",
"email":"test@test.com"
},
"principal":{
"principal_name":"Bob",
"principal_id_number":"5555-8888"
},
}
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| PARAM_ERROR | 请求参数未按指引进行填写 | 具体参数格式可以查看文档 |
| INVALID_REQUEST | 商户系统异常导致，商户权限异常、重复请求支付、证书错误、频率限制、商户号不存在、appid和mchid不存在绑定关系、渠道号不对等 | 请根据接口返回的详细错误描述信息检查您的程序 |
| SYSTEM_ERROR | 后台系统返回错误 | 系统异常，请使用原参数重新发起 |
| Mch_NOT_EXISTS | 对应的子商户没有审批通过 | 在创建子商户5分钟后调用查询接口确认是否成功，如果报子商户不存在，请重新申请 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证