收款(个人转账版)服务
接口文档
1简介
为规范服务商下属个人用户的接入,服务商需将个人用户基本资料提交给支付,支付返回下属个人用户的收款识别码。因为用户的数量较多,服务商可以直接调用该系列API实现高效快捷的录入个人用户的资料。
2接口规则
春花的诗句协议规则详见
pay.weixin.qq/wiki/doc/api/jsapi_sl.php?chapter=4_1签名与算法详见
pay.weixin.qq/wiki/doc/api/jsapi_sl.php?chapter=4_3
3API详细介绍世界最二国家
3.1新增收款个人用户资料API
服务商调用该接口将收款个人用户资料提交给侧,根据提交的资料情况,判断收款用户资料正确性,返回收款识别码;
油腻腻的什么3.1.1接口URL
h.weixin.qq/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。
发布评论