关闭

Login expired. Please log in again.

Feedback

0/300
Submit

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

子商户进件（融合钱包）

接入指引
接口规则
参数规定
公共API
进件子商户
查询子商户
修改子商户
联系我们
联系我们
返回上一层 子商户进件（融合钱包） / 进件子商户API

进件子商户

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


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

注意：

● 本接口请求的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 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名 变量 类型 必填 描述
机构appid sp_appid string(32) 是 body机构在微信公众平台申请服务号对应的APPID
注意：仅适用于机构模式
示例值：wx8888888888888888
机构商户号 sp_mchid string(32) 是 body微信支付分配的机构商户号
注意：仅适用于机构模式
示例值：3200000001
子商户全称 name string(128) 是 body子商户公司注册的名称
示例值：Merchant name
子商户简称 shortname string(64) 是 body子商户简称，用于微信订单详情和支付成功页展示
示例值：Merchant shortname
公司电话 office_phone string(32) 是 body公司电话
示例值：075586010000
+ 联系人信息 contact object 是 body联系人信息，详细说明见
参数名 变量 类型 必填 描述
联系人名称 name string(64) 是 联系人名称，该字段需进行加密处理，加密方法详见下面说明
示例值：李先生
联系人电话 phone string(32) 是 联系人电话，该字段需进行加密处理，加密方法详见下面说明
示例值：075586010000
联系人邮箱 email string(256) 是 联系人邮箱，该字段需进行加密处理，加密方法详见下面说明
示例值：test@test.com
类目 business_category int 是 body参考附录，详见商业类目列表
示例值：644
渠道号 channel_id string(20) 否 body机构在微信商户管理后台创建的渠道号，如有渠道号请填写
示例值：3200000001
注册国家或区域 merchant_country_code string(3) 是 body子商户公司注册的国家或区域
示例值：344
商户类型 merchant_type string(10) 是 body 取值ENTERPRISE或INDIVIDUAL
若商户为自然人或独资经营者，请选择INDIVIDUAL。
示例值：ENTERPRISE
公司注册文件编号 registration_certificate_number string(50) 是 body 公司注册文件编号。
若商户为自然人，请提供董事或负责人的ID号。
若商户为独资经营者，请提供独资经营的业务资质证书编号。
示例值：5555-8888
公司注册文件过期时间 registration_certificate_date string(10) 是 body 公司注册文件过期时间。
取值为过期的日期或取值为“PERMANENT”，“N/A”, 若取值为日期，格式为YYYY-MM-DD，比如2020-10-16。
若商户为自然人，请提供董事或负责人的ID号过期日期。
若商户为独资经营者，请提供独资经营的业务资质证书编号过期日期。
示例值：2020-10-16
公司注册文件照片 registration_certificate_copy string(128) 否 body公司注册文件的照片，取值为《上传图片API（For HK）》返回的media ID.
示例值：w7yQFawBtja5uEdm_aoGhHuxkrIaqB4GzPCeo963zXKcO2hDVD8AjXIpgrj-x95m5iclsanHYauUt1__DsWXok2NqRliv2SDL42QoEmHIPs
子商户银行结算账户信息 settlement_bank_number string(128) 否 body子商户的结算银行账户信息
示例值：555588889999
+ 业务信息 business object 是 body业务信息，具体请参考business对象列表
参数名 变量 类型 必填 描述
业务类型 business_type string(7) 是 业务类型为ONLINE，OFFLINE或BOTH
示例值：BOTH
APP下载链接 app_download string(128) 是/否 商户APP的下载地址，当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入
示例值：https://download.qq.com
业务网站 website string(128) 是/否 当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入
示例值：https://www.qq.com
公众号 office_account string(128) 是/否 当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入
示例值：wx8888888888888888
小程序 mini_program string(128) 是/否 当业务类型取值为ONLINE或BOTH时，app_download, bus_website，office_account, mini_program四项中至少选择一项传入
示例值：wx8888888888888888
门店地址 store_address string(128) 是/否 商户门店地址，当业务类型取值为OFFLINE或BOTH时必传
示例值：10F World Finance Centre (South Office), 11 Canton Road, Tsim Sha Tsui, Hong Kong
门店照片 store_photos String(1024) 是/否 商户门店照片，当业务类型取值为OFFLINE或BOTH时必传。至少上传三张门店照片。取值为上传图片API返回的media ID. 多个图片，使用Json数组格式提交.
示例值：[Media_id1, Media_id2, Media_id3]
MCC码 mcc String(4) 是/否 Mcc码，详见商户行业编码
示例值：4214
+ 董事信息 director object 是/否 body董事信息，当商户类型为ENTERPRISE必传，具体请参考director对象列表
参数名 变量 类型 必填 描述
董事姓名 name string(128) 否 董事姓名，当商户类型为ENTERPRISE时选择填入
示例值：Bob
董事证件号 number string(128) 否 董事证件号码，当商户类型为ENTERPRISE时选择填入
示例值：5555-8888
+ 负责人信息 principal object 是/否 body负责人信息，当商户类型为INDIVIDUAL必传，具体请参考principal对象列表
参数名 变量 类型 必填 描述
负责人姓名 name string(128) 否 负责人姓名，当商户类型为INDIVIDUAL时选择填入
示例值：Bob
负责人证件号 number string(128) 否 负责人证件号，当商户类型为INDIVIDUAL时选择填入
示例值：5555-8888

敏感字段加密说明：

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

加密步骤：

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

2、使用微信支付平台证书的公钥，对于需要加密的参数值进行RSA加密。Java语言的加密方法的填充方案使用 RSA/ECB/PKCS1Padding ;PHP填充方式为OPENSSL_PKCS1_PADDING。

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


请求示例：


{
    "sp_appid": "wx82ec4jy334ner1", 
    "sp_mchid": "2422128905",   
    "name": "testname", 
    "shortname": "shortname", 
    "office_phone": "13680534111", 
    "contact": {
        "email": "gP32/1QSaIpKlaFbWgP3hr8W3+YTtiavMRbOJJ6dATymJzxx/b4YPOTKdeRApW6Nt2ZZB9reZ1x45XhIEF/Ztb6mqfFVb6LxpJlHgDL/zpUG51551XQ3Ww+/kVCJcokiIiT1bSwEcCe6tPL2cmdsOEjlTikyrasLc1bG8vaG/i361r0vX9w56O2Mgv3OnJ4fr4xnmxNcVrJnk1f/gBSIiCUWA0163f3LM4KifQelEuz/WtroeKAzRDiI0/pOvXfwrYDK==", 
        "name": "Vxjsrod2RT2aGxeI5i+Z2C4arXYGXZuwE8IrRf6uYu6S5dy4Igw7kjvYWYCNfsgcdXyfjdA4KVntbgSa3zic+ERsOd5u+SNKkaFSH3SwYtpcCyaUMvICTw/6AOY/qy+He9la/gxObgi4zkxvLJmZTJVualTVJWWCIvcuDArW8Kfqp8rBl+IxDEgCojoEmqE7ymVReslGBXWiaPS1UsZx1QJyez3/ijzBa4AKch3XuPx6d3qvM+J8iMx/b94LAfpTihU/j==", 
        "phone": "l8JH2dAGLNJ8P5DENoMV0eW4JgIquV2ZO4conHnZp48g/eVpgvIfMj4Ge6LRVENW4eZksErJnYCQB+EOFEGR0lMhA1LexPLu0en08iM2ghkftYWAsOD4JPkvvc36SAfWal29eoZh4maO6kOGW7G4uBua6JoMsEjR6uuw5Gw5DC2eikcdkDBGk9vHSP/oxRs3Qu8a83GikhLgdpAPitXbZX/TEPG5SUg8Fx4BCMCKOfxy8uakq2/EeCtyBMjaiheUePoA=="
    }, 
    "business_category": 343, 
    "merchant_country_code": "344", 
    "merchant_type": "ENTERPRISE", 
    "registration_certificate_number": "519723407213085723", 
    "registration_certificate_date": "2022-06-03", 
    "settlement_bank_number": "559304578245298347923856", 
    "business": {
        "business_type": "ONLINE", 
        "mcc": "5344", 
        "mini_program": "flowerplus"
    }, 
    "director": {
        "name": "Tom", 
        "number": "1234567890"
    }
}

    
｛
JAVA示例代码
｝

返回参数

正常返回

参数名 变量 类型 必填 描述
子商户号 sub_mchid string(32) 是 微信支付分配的子商户号
注意：仅适用于机构模式
示例值：1900000109
验证状态 verification_status string(32) 否 验证状态:
Under Review：审核中
Approved：已批准
示例值：Under Review
验证状态描述 description string(128) 否 审核状态描述。
示例值：该子商户需要通过审核才可生效。请登录商户平台检查审核状态。

异常返回

参数名 变量 类型 必填 描述
返回状态码 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 商户唯一标识已经存在，请更换 针对不同的子商户，请定义唯一的标识


版本说明

关闭
V1.1
2020年12月04日
1. 新增参数：merchant_country_code, merchant_type, mcc, registration_certificate_number,registration_certificate_date, registration_certificate_copy, business_type, app_download, website, settlement_bank_number, business, director 和 principle.
删除参数： website 、introduction
V1.0
2020年1月08日
1. 创建子商户接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

ICP证

粤B2-20090059

Back to top