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

返回上一层融合钱包 / 付款码支付 / 创建子商户API

创建子商户

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

机构提交子商户资料，微信支付系统会为每个子商户创建子商户号。

注意：

● 本接口请求的header需包含Idempotency-Key参数，它是一个由商户侧生成的唯一key，微信服务器使用该值来识别多次重试是否为同一请求，该字段长度64位，可包含字母和数字。

接口说明

适用对象:机构模式

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

请求方式: POST

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

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

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

请求参数

参数名

变量

类型

必填

描述

机构appid

sp_appid

string(32)

是

query机构在微信公众平台申请服务号对应的APPID
注意：仅适用于机构模式
示例值：wx8888888888888888

机构商户号

sp_mchid

string(32)

是

query微信支付分配的机构商户号
注意：仅适用于机构模式
示例值：3200000001

子商户全称

name

string(50)

是

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

子商户简称

shortname

string(20)

是

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

公司电话

office_phone

string(20)

是

query公司电话，该字段需进行加密处理，加密方法详见下面说明
示例值：075586010000

+ 联系人信息

contact

object

否

query联系人信息，详细说明见

参数名	变量	类型	必填	描述
联系人名称	name	string(10)	否	联系人名称，该字段需进行加密处理，加密方法详见下面说明示例值：李先生
联系人电话	phone	string(16)	否	联系人电话，该字段需进行加密处理，加密方法详见下面说明示例值：075586010000
联系人邮箱	email	string(30)	否	联系人邮箱，该字段需进行加密处理，加密方法详见下面说明示例值：test@test.com

公司简介

introduction

string(256)

是

query公司简介，主要说明公司经营什么领域产品
特殊规则：最小长度取值为10。
示例值：主要经营酒店餐饮

公司网站

website

string(128)

否

query公司网站地址
示例值：http://xxx.home.page

类目

business_category

int

是

query参考附录
示例值：101

子商户唯一标识

business_code

string(20)

是

query子商户在机构下面的唯一标识
示例值：X000001

渠道号

channel_id

string(32)

否

query机构在微信商户管理后台创建的渠道号，如有渠道号请填写
示例值：3200000001

敏感字段加密说明：

对于包含了敏感信息的参数，如联系方式等，我们增加了“字段加密”的安全机制，保护敏感信息只能被数据的接收方看到。

加密步骤：

1、获取微信支付平台证书和对应的平台证书序列号，详细方法参考5.7下载平台证书。本接口请求http头的“Wechatpay-Serial”需要传平台证书序列号。

2、使用微信支付平台证书的公钥，对于需要加密的参数值进行RSA加密。填充方案使用`RSAES-PKCS1-v1_5`。

3、加密后的密文，使用base64编码后，作为请求中相应参数的值。

请求示例：

JSON


{
    "sp_appid": "wx8888888888888888",
    "sub_mchid": "3200000001",
	"name": "Merchant name",
	"shortname": "Merchant shortname",
	"office_phone": "075586010000",
	"contact": {
	    "name": "李先生",
		"phone": "075586010000",
		"email": "test@test.com"
	}
	"introduction": "主要经营酒店餐饮",
	"website": "http://xxx.home.page",
	"business_category": 101,
	"business_code": "X000001",
	"channel_id": "3200000001"

}

    
｛
JAVA示例代码
｝

返回参数

正常返回

参数名	变量	类型	必填	描述
子商户号	sub_mchid	string(32)	是	微信支付分配的子商户号注意：仅适用于机构模式示例值：1900000109

异常返回

参数名

变量

类型

必填

描述

返回状态码

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

返回示例：

{
    "sub_mchid": "20000100"
}

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

错误码

错误码	描述	解决方案
PARAM_ERROR	请求参数未按指引进行填写	具体参数格式可以查看文档
SYSTEM_ERROR	后台系统返回错误	系统异常，请使用原参数重新发起
INVALID_REQUEST	商户系统异常导致，商户权限异常、重复请求支付、证书错误、频率限制、商户号不存在、appid和mchid不存在绑定关系、渠道号不对等	请根据接口返回的详细错误描述信息检查您的程序，具体可以查询detail 字段返回的详细信息
INVALID_REQUEST	没有api创建子商户的权限	请登录商户管理后台人工录入子商户信息
INVALID_REQUEST	商户唯一标识已经存在，请更换	针对不同的子商户，请定义唯一的标识

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

付款码支付

创建子商户

注意：

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码

版本说明