微信支付-融合钱包开发者文档

返回上一层融合钱包 / APP支付 / 查询子商户API

查询子商户

最新更新时间：2020.1.08 版本说明

用于机构查询子商户创建是否成功，接口只提供单个子商户信息查询。

接口说明

适用对象:机构模式

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

请求方式: GET

接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指该参数需在请求URL传参

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

请求参数

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

请求示例：


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

    
｛
JAVA示例代码
｝

返回参数

正常返回

参数名	变量	类型	必填	描述
子商户全称	name	string(50)	是	子商户公司注册的名称示例值：Merchant name
子商户简称	shortname	string(20)	是	子商户简称，用于微信订单详情和支付成功页展示示例值：Merchant shortname
公司联系方式	office_phone	string(20)	是	商户联系方式，用户支付完成后展示给用户的商家联系方式示例值：075586010000
公司简介	introduction	string(256)	是	商户简介，主要经营什么领域产品特殊规则：最小长度取值为10。示例值：主要经营酒店餐饮
公司网站	website	string(128)	否	公司网站示例值：http://xxx.home.page
类目	business_category	int	是	参考附录示例值：101

异常返回

参数名

变量

类型

必填

描述

返回状态码

code

string(32)

是

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

返回信息

message

string(256)

是

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

+ 详细的错误描述

detail

object

否

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

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

返回示例：

{
	"name":"test mcherchan_name ",
	"shortname":"mcherchan_name",
	"office_phone":"075586010000",
	"merchant_introduction":"hotel and restaurant",
	"website":"http://xxx",
	"business_category":101
}

{
"code":"INVALID_REQUEST",
"message":"参数格式校验错误",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"与ALLOF schema不符",
    "location":"body"
   }
}

错误码

错误码	描述	解决方案
PARAM_ERROR	请求参数未按指引进行填写	具体参数格式可以查看文档
INVALID_REQUEST	商户系统异常导致，商户权限异常、重复请求支付、证书错误、频率限制、商户号不存在、appid和mchid不存在绑定关系、渠道号不对等	请根据接口返回的详细错误描述信息检查您的程序
SYSTEM_ERROR	后台系统返回错误	系统异常，请使用原参数重新发起
Mch_NOT_EXISTS	对应的子商户没有审批通过	在创建子商户5分钟后调用查询接口确认是否成功，如果报子商户不存在，请重新申请

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

APP支付

查询子商户

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码