银行特约商户录入API

应用场景

银行服务商接入微信支付前需要将下属特约商户基本资料信息报备给微信,在微信支付侧生成特约商户识别码后方可提交微信支付。特约商户识别码是区分子商户交易、结算和清分的标志。

银行服务商需先在管理后台录入渠道,渠道审核通过后,才可以录入特约商户。银行特约商户数量较多,一般采调用该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 银行为其渠道商申请(在服务商平台申请,请见《渠道录入指引》)的渠道标识.银行直连商户也需要单独申请渠道号  
经营类目 business String(10) 101 行业类目,请填写对应的ID,见详细列表
联系人微信账号类型 contact_wechatid_type String(32) type_openid 如传微信号,值为type_wechatid
如果“收款人微信账号”要传openid,值为type_openid
联系人微信帐号 contact_wechatid String(32) OPENID_012312321 微信号:打开微信,在"个人信息"中查看到的"微信号"
openid:需在服务商appid下通过OAUTH2.0接口获取用户的openid,此处传openid的具体值
商户备注 merchant_remark String(20) 商户的唯一备注 同一个受理机构,特约商户“商户备注”唯一。 商户备注重复时,生成商户识别码失败,并返回提示信息“商户备注已存在,请修改后重新提交”
注:
1.除商户名称、商户简称、联系人、商户备注的长度为中文字符个数,其他均为字节数
2.参数值用XML转义或加CDATA标签用于说明数据不被XML解析器解析。

返回结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 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编码,请检查后重试
可以从utf-8转为gbk XXX中包含了非法字符,请检查后重试
例如:商户名称中包含了非法字符,请检查后重试
联系人、商户简称、商户名称需要通过敏感词校验 校验商户信息时发生系统错误,请尝试再次调用
校对商户信息时发生系统错误,请尝试再次调用
你输入的字段中包含违反法律法规的内容,请检查后重新输入
你输入的字段中涉及敏感字眼,不符合相关规定,请检查后重新输入
该公司因违规,暂不能接入微信支付,可联系客服获取更多详情
该公司因受协议保护,暂不能通过该申请渠道接入微信支付,可联系客服获取更多详情
你输入的字段中涉及敏感字眼,不符合相关规定,请检查后重新输入
人工检查过滤
长度限制 XXX填写有误,请检查后重新提交
正则校验 XXX内容格式有误,请检查后重试
录入权限 暂无权限,请检查后重试 检查权限
需要证书 获取客户端证书序列号失败
获取客户端证书特征名称(DN)域失败
证书校验失败,请检查后重试
检查证书