Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

子商户进件(融合钱包)

接入指引
接口规则
参数规定
公共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