银行特约商户录入API
更新时间：2024.11.18应用场景
银行服务商接入微信支付前需要将下属特约商户基本资料信息报备给微信，在微信支付侧生成特约商户识别码后方可提交微信支付。特约商户识别码是区分子商户交易、结算和清分的标志。
银行服务商需先在管理后台录入渠道，渠道审核通过后，才可以录入特约商户。银行特约商户数量较多，一般采调用该API实现快速录入（注意：普通商户和普通服务商不可调用该接口 )。该接口有频率1次/秒限制。
银行服务商调用该接口将特约商户资料提交微信侧，微信根据提交的资料情况，判断商户资料正确性，返回识别码；如商户资料有误，返回相应的错误码。
接口链接
URL地址：https://api.mch.weixin.qq.com/secapi/mch/submchmanage?action=add
是否需要证书
是
请求参数
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
公众账号ID | appid | 是 | String(32) | wxd678efh567hg6787 | 银行服务商的公众账号ID |
商户号 | mch_id | 是 | String(32) | 1230000109 | 银行服务商的商户号 |
签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 通过签名算法计算得出的签名值，详见签名生成算法 |
商户名称 | merchant_name | 是 | String(50) | 商户名称 | 该名称是公司主体全称，绑定公众号时会对主体一致性校验 |
商户简称 | merchant_shortname | 是 | String(20) | 商户简称 | 该名称是显示给消费者看的商户名称 |
客服电话 | service_phone | 是 | String(20) | 075586010000 | 方便微信在必要时能联系上商家，会在支付详情展示给消费者 |
联系人 | contact | 否 | String(10) | 联系人 | 方便微信在必要时能联系上商家。 |
联系电话 | contact_phone | 否 | String(11) | 13000000000 | 方便微信在必要时能联系上商家。 |
联系邮箱 | contact_email | 否 | String(30) | test@test.com | 方便微信在必要时能联系上商家。 |
渠道号 | channel_id | 是 | String(32) | 10100000 | 银行为其渠道商申请（在服务商平台申请，请见渠道录入指引.pdf的渠道标识，银行直连商户也需要单独申请渠道号 |
经营类目 | business | 是 | String(10) | 101 | 行业类目，请填写对应的ID，见详细列表 |
联系人微信账号类型 | contact_wechatid_type | 否 | String(32) | type_openid | 如传微信号，值为type_wechatid |
联系人微信账号 | contact_wechatid | 否 | String(32) | OPENID_012312321 | 微信号：打开微信，在"个人信息"中查看到的"微信号" |
商户备注 | merchant_remark | 是 | String(20) | 商户的唯一备注 | 同一个受理机构，特约商户“商户备注”唯一。 商户备注重复时，生成商户识别码失败，并返回提示信息“商户备注已存在，请修改后重新提交” |
|
返回结果
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断 |
返回信息 | return_msg | 否 | String(128) | 签名失败 | 返回信息，如非空，为错误原因 签名失败 参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
商户号 | mch_id | 是 | String(32) | 1900000109 | 调用接口提交的商户号 |
商户识别码 | sub_mch_id | 是 | String(32) | 013467007045764 | 微信支付分配的商户识别码 |
处理结果 | result_code | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | SUCCESS/FAIL |
处理信息 | result_msg | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 结果信息描述。处理成功，错误原因提示等 |
错误码
名称 | 描述 | 解决方案 |
|---|---|---|
不支持http get方法 | 请使用post方法,请检查后重新提交 | 开发联调解决 |
Xml格式错误 | 输入xml参数格式错误，请检查后重新提交 | |
验签 | 签名校验失败，请检查后重试 | |
使用utf-8编码格式 | XXX未使用UTF-8编码，请检查后重试 | |
可以从utf-8转为gbk | XXX中包含了非法字符，请检查后重试 | |
联系人、商户简称、商户名称需要通过敏感词校验 | 校验商户信息时发生系统错误，请尝试再次调用 | 人工检查过滤 |
长度限制 | XXX填写有误，请检查后重新提交 | |
正则校验 | XXX内容格式有误，请检查后重试 | |
录入权限 | 暂无权限，请检查后重试 | 检查权限 |
需要证书 | 获取客户端证书序列号失败 | 检查证书 |
