微信收款个人转账版服务接口文档

微信收款（个人转账版）服务

接口文档

1简介

为规范服务商下属个人用户的接入，服务商需将个人用户基本资料提交给微信支付，微信支付返回下属个人用户的收款识别码。因为用户的数量较多，服务商可以直接调用该系列API实现高效快捷的录入个人用户的资料。

2接口规则

协议规则详见

https:///wiki/doc/api/jsapi_sl.php?chapter=4_1签名与算法详见

https:///wiki/doc/api/jsapi_sl.php?chapter=4_3

3API详细介绍

3.1新增收款个人用户资料API

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

3.1.1接口URL

https:///secapi/mch/submchmanage?action=add

是否需要证书

需要

3.1.2请求参数

字段名变量名必填类型说明

服务商公众账号ID appid是String(32)微信分配的服务商账号ID

服务商商户号mch_id是String(32)微信支付分配的服务商商户号签名sign是String(32)签名，详见签名生成算法

店铺名称merchant_name是String(128)须与营业执照的名称保持一致，

最长为42个中文字符，128个

英文字符

店铺简称merchant_shortname是String(48)该名称将于支付成功页向消费者

进行展示，最长为16个中文字

符，48个英文字符

收款人姓名recipient_name是String(20)收款人姓名，姓名中间不能有空

格

收款人身份证recipient_idcardno是String(18)收款人身份证，

最长18位，数字+X

收款人微信号recipient_wechatid是String(32)需打开微信，在“个人信息”中

看到的“微信号”，操作指引见

图1，如“微信号”一栏显示“未

设置”，需先进行设置

经营类目business是String(12)传类目ID，须与实际售卖商品保

持一致，类目ID表内容见附录1收款用户ID merchant_remark是String(32)收款ID,是服务商系统内部的用

户ID，同一个服务商，其收款ID

需唯一。收款ID重复时，生成收

款识别码失败，建议使用服务商

管理用户时的系统内部唯一id 客服电话service_phone否String(40)格式只能为数字加中杠

店铺地址国标编码merchant_gbaddress是String(6)传地址对应的国标ID，

点击查看国标ID详情

店铺详细地址merchant_detailaddress是String(96)最长为32个汉字，96个英文字

符，例如：XX街道XX路XX号联系人contact否String(20)联系人，以方便微信在必要时能

联系上商家

联系电话contact_phone否String(11)联系电话，以方便微信在必要时

能联系上商家

联系邮箱contact_email否String(60)联系邮箱，以方便微信在必要时

能联系上商家

3.1.2返回参数

字段名变量名必填类型说明

返回状态码return_code是String(16)SUCCESS/FAIL

此字段是通信标识，请求是否成

功需要查看result_code来判断返回信息return_msg是String(128)返回信息为错误原因，如“签名

失败”，如成功返回“OK”

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

服务商商户号mch_id是String(32)微信支付分配的服务商商户号处理结果result_code是String(32)SUCCESS/FAIL

错误代码err_code否String(32)result_code为FAIL时有返回，

详细参见错误码列表

错误代码描述err_code_des否String(128)result_code为FAIL时有返回，

详细参见错误码列表签名sign是String(32)签名，详见签名生成算法

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

收款识别码micro_mch_id是String(32)微信支付分配的收款识别码

3.1.3错误码

错误码错误信息说明

NOT_UTF8XXX(字段名称)内容未使用UTF-8编码，请

检查后重试

接口字段需使用UTF-8编码

PARAMS_FORMAT_ERROR1，XXX(字段名称)内容格式有误，请检查

后重试；

2，XXX(字段名称)超出限定字符串长度，

请检查后重试；1，检查手机号码/身份证/姓名是否有空格

2，检查字符串是否超出限定长度

BUSINESS_ERROR1，输入的类目ID有误，请查阅最新类目ID

表，检查后重试

2，输入的类目已不再对外开放，请查阅最

新类目ID表，检查后重试1.检查类目ID是否正确；

2.检查当前类目ID是否是对外开放状态

WECHATID_ERROR收款人微信号有误，请检查后重试检查收款人微信号是否正确

WECHATID_BINDLIMIT收款人微信号已绑定收款识别码，且绑定关

系条目数已达上限，请更换微信号后重试微信ID已有绑定多少个收款识别码，一个微信号目前最多对应5个收款识别码

WECHATID_NOT_REALNAME收款人微信号未进行实名认证，请绑定一张

银行卡后重试

检查微信号是否已进行实名

WECHATID_CHECK_ERROR收款人微信号实名信息与姓名、身份证信息

不匹配，请检查后重试检查微信号实名信息是否与身份证和姓名一致

SIGNERROR

签名错误请检查签名参数和方法是否都符合签名算法要求

SYSTEMERROR接口返回错误请尝试再次掉调用API。