绑定APPID配置

更新时间:2024.11.18

应用场景

服务商给特约子商户配置绑定关系;

注意

API只支持新增配置,不支持修改, 如银行需要修改请先登录微信服务商后台手工删除后重新配置;
可以绑定特约商户或渠道公司名字相同的公众号、小程序、开放平台应用的APPID; 如果提交绑定了subappid,支付接口就一定要传。

接口链接

URL地址: https://api.mch.weixin.qq.com/secapi/mch/addsubdevconfig

是否需要证书

请求参数

名称

变量名

必填

类型

示例值

描述

公众账号ID

appid

String(32)

wx931386123456789e

银行服务商的公众账号 ID

商户号

mch_id

String(32)

1451234567

银行服务商的商户号

特约商户号

sub_mch_id

String(32)

10000101

银行服务商报备的特约商户识别码

关联APPID

sub_appid

String(32)

wx931386123456789e

绑定特约商户或渠道公众号、小程序、APP支付等对应的APPID

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名,详见签名生成算法

返回结果

名称

变量名

必填

类型

示例值

描述

返回状态码

return_code

String(16)

SUCCESS

SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断

返回信息

return_msg

String(128)

签名失败

返回信息,如非空,为错误原因 签名失败 参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

名称

变量名

必填

类型

示例值

描述

业务结果

result_code

String(32)

FAIL

SUCCESS/FAIL

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

微信返回的签名,银行服务商需验证签名,详见签名生成算法

错误代码

err_code

String(32)

INVALID_REQUEST

当result_code为FAIL时返回错误代码,详见错误列表

错误代码描述

err_code_des

String(128)

子商户号信息有误,请检查修改后重试

结果信息描述

错误码

错误码

名称

描述

解决方案

INVALID_REQUEST

不支持http get方法

请使用post方法,请检查后重新提交

开发联调解决

INVALID_REQUEST

Xml格式错误

输入xml参数格式错误,请检查后重新提交

SIGNERROR

验签

签名校验失败,请检查后重试

INVALID_REQUEST

使用utf-8编码格式

XXX未使用UTF-8编码,请检查后重试 
例如:公众号支付域名未使用UTF-8编码,请检查后重试

PARAM_ERROR

长度限制

XXX填写有误,请检查后重新提交

人工检查过滤

PARAM_ERROR

正则校验

XXX内容格式有误,请检查后重试

请检查内容格式后重试

INVALID_REQUEST

录入权限

暂无权限,请检查后重试

检查权限

INVALID_REQUEST

需要证书

获取客户端证书序列号失败 
获取客户端证书特征名称(DN)域失败 
证书校验失败,请检查后重试

检查证书

INVALID_REQUEST

校验公众号和服务商关系

appid与mchid无绑定关系,请检查修改后重试

检查输入参数

INVALID_REQUEST

校验服务商和子商户关系

子商户号信息有误, 请检查修改后重试

请确认子商户号后重试

INVALID_REQUEST

校验公众号是否合法

校验appid发生错误, 请检查修改后重试

请确认appid后重试

 

反馈
咨询
目录
置顶