新增收款个人用户API

应用场景

服务商调用该接口将收款个人用户资料提交给微信侧,微信根据提交的资料情况,判断收款用户资料正确性,返回收款识别码

接口链接

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(128)

小王便利店 须与营业执照的名称保持一致,最长为42个中文字符,128个英文字符验

店铺简称

merchant_shortname

String(48)

店铺简称 该名称将于支付成功页向消费者进行展示,最长为16个中文字符,48个英文字符

收款人姓名

recipient_name

String(20)

小王 收款人姓名姓名中间不能有空格

收款人身份证

recipient_idcardno

String(18)

440307198765441111 收款人身份证姓名最长18位 ,数字+X

收款人微信账号类型

recipient_wechatid_type

String(32)

type_openid 该字段不传,则系统默认认为“收款人微信账号”传的是微信号,如果“收款人微信账号”要传openid,该字段必传,值为type_openid

收款人微信账号

recipient_wechatid

String(32)

wechatName 微信号:需打开微信,在“个人信息”中看到的“微信号”,操作指引见图1,如“微信号”一栏显示“未设置”,需先进行设置

openid:需在服务商appid下通过OAUTH2.0接口获得用户的openid,此处传openid的具体值

经营类目

business

String(12)

101

传类目ID,须与实际售卖商品保持一致,类目ID表

收款用户ID

merchant_remark

String(32)

001

收款ID,是服务商系统内部的用户ID,同一个服务商,其收款ID需唯一。收款ID重复时,生成收款识别码失败,建议使用服务商管理用户时的系统内部唯一id

客服电话

service_phone

String(40)

075586010000

方格式只能为数字加中杠

店铺地址国标编码

merchant_gbaddress

String(6)

110000 收传地址对应的国标ID
点击查看国标ID详情

店铺详细地址

merchant_detailaddress

String(96)

南山街道科技中一路10000号

最长为同32个汉字,96个英文字符。,例如:XX街道XX路XX号

联系人

contact

String(20)

联系人

联系人,以方便微信在必要时能联系上商家

联系电话

contact_phone

String(11)

13000000000

联系电话,以方便微信在必要时能联系上商家

联系邮箱

contact_email

String(60)

test@test.com

联系邮箱,以方便微信在必要时能联系上商家

返回结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) SUCCESS

SUCCESS/FAIL

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

返回信息 return_msg String(128) 签名失败

返回信息为错误原因,如“签名失败”,如成功返回“OK”

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

字段名 变量名 必填 类型 示例值 描述
服务商商户号 mch_id String(32) 1900000109 调用接口提交的服务商商户号

处理结果

result_code

String(32) SUCCESS

SUCCESS/FAIL

错误代码

err_code

String(32) NOT_UTF8

result_code为FAIL时有返回,详细参见错误码列表

错误代码描述

err_code_des

String(128) XXX(字段名称)内容未使用UTF-8编码,请检查后重试

result_code为FAIL时有返回,详细参见错误码列表

签名

sign

String(32) C380BEC2BFD727A4B6845133519F3AD6

签名

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

字段名 变量名 必填 类型 示例值 描述
收款识别码 micro_mch_id String(32) 12345678 微信支付分配的收款识别码

错误列表:

错误码 错误信息 解决方案
NOT_UTF8 XXX(字段名称)内容未使用UTF-8编码,请检查后重试 接口字段需使用UTF-8编码
PARAMS_FORMAT_ERROR 1, XXX(字段名称)内容格式有误,请检查后重试;
校对商户信息时发生系统错误,请尝试再次调用
2, XXX(字段名称)超出限定字符串长度,请检查后重试
1,检查手机号码/身份证/姓名是否有空格
2,检查字符串是否超出限定长度
BUSINESS_ERROR 1,输入的类目ID有误,请查阅最新类目ID表,检查后重试
2,输入的类目已不再对外开放,请查阅最新类目ID表,检查后重试
1.检查类目ID是否正确
2.检查当前类目ID是否是对外开放状态
WECHATID_ERROR 收款人微信号有误,请检查后重试 检查收款人微信号是否正确
WECHATID_BINDLIMIT 收款人微信号已绑定收款识别码,且绑定关系条目数已达上限,请更换微信号后重试 微信ID已有绑定多少个收款识别码,一个微信号目前最多对应5个收款识别码
WECHATID_NOT_REALNAME 收款人微信号未进行实名认证,请绑定一张银行卡后重试 检查微信号是否已进行实名
WECHATID_CHECK_ERROR 收款人微信号实名信息与姓名、身份证信息不匹配,请检查后重试 检查微信号实名信息是否与身份证和姓名一致
SIGNERROR 签名错误 请检查签名参数和方法是否都符合签名算法要求
SYSTEMERROR 接口返回错误 请尝试再次掉调用API
图1:
  如“微信号”一栏显示“未设置”,需先进行设置