当前位置：文档之家 › 微信收款个人转账版服务接口文档

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

  • 格式：pdf
  • 大小：381.35 KB
  • 文档页数：13

微信收款（个人转账版）服务接口文档1简介为规范服务商下属个人用户的接入，服务商需将个人用户基本资料提交给微信支付，微信支付返回下属个人用户的收款识别码。

因为用户的数量较多，服务商可以直接调用该系列API实现高效快捷的录入个人用户的资料。

2接口规则协议规则详见https:///wiki/doc/api/jsapi_sl.php?chapter=4_1签名与算法详见https:///wiki/doc/api/jsapi_sl.php?chapter=4_33API详细介绍3.1新增收款个人用户资料API服务商调用该接口将收款个人用户资料提交给微信侧，微信根据提交的资料情况，判断收款用户资料正确性，返回收款识别码；3.1.1接口URLhttps:///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。

3.2查询收款个人用户资料API服务商调用该接口通过传入“收款识别码”或“收款人微信号”，来获取收款个人用户的相关资料信息3.2.1接口URLhttps:///secapi/mch/submchmanage?action=query是否需要证书需要3.2.2请求参数字段名变量名必填类型说明服务商公众账号ID appid是String(32)微信分配的服务商公众账号ID 服务商商户号mch_id是String(32)微信支付分配的服务商商户号收款识别码micro_mch_id二选一String(32)微信支付分配的收款识别码收款人微信号recipient_wechatid String(32)需打开微信，在“个人信息”中看到的“微信号”，操作指引见图1，如“微信号”一栏显示“未设置”，需先进行设置签名sign是String(32)签名，详见签名生成算法3.2.3返回参数字段名变量名必填类型说明返回状态码return_code是String(16)SUCCESS/FAIL此字段是通信标识，请求是否成功需要查看result_code来判断返回信息return_msg是String(128)返回信息为错误原因，如“签名失败”，如成功返回“OK”以下字段在return_code为SUCCESS的时候有返回服务商公众账号ID appid是String(32)微信分配的服务商公众账号ID 服务商商户号mch_id是String(32)微信支付分配的服务商商户号总记录数record_num是String(10)返回收款个人用户数据的个数签名sign是String(32)签名，详见签名生成算法处理结果result_code是String(32)SUCCESS/FAIL错误代码err_code否String(32)result_code为FAIL时有返回，详细参见错误码列表错误代码描述err_code_des否String(128)result_code为FAIL时有返回，详细参见错误码列表以下字段在result_code为SUCCESS的时候有返回,下标n从0开始收款识别码micro_mch_id_$n是String(32)微信支付分配的收款识别码店铺名称merchant_name_$n是String(128)须与营业执照的名称保持一致，最长为42个中文字符，128个英文字符店铺简称merchant_shortname_$n是String(48)该名称将于支付成功页向消费者进行展示，最长为16个中文字符，48个英文字符收款人姓名recipient_name_$n是String(20)收款人姓名，姓名中间不能有空格收款人身份证recipient_idcardno_$n是String(18)收款人身份证，最长18位，数字+X收款人微信号recipient_wechatid_$n是String(32)需打开微信，在“个人信息”中看到的“微信号”，操作指引见图1，如“微信号”一栏显示“未设置”，需先进行设置经营类目business_$n是String(12)传类目ID，须与实际售卖商品保持一致，类目ID表内容见附录1收款用户ID merchant_remark_$n是String(32)收款用ID,是服务商系统内部的用户ID，同一个服务商，其用户ID需唯一。

用户ID重复时，生成收款识别码失败，建议使用服务商管理用户时的系统内部唯一id客服电话service_phone_$n否String(40)格式只能为数字加中杠店铺国标编码地址+详细地址merchant_address_$n是String(128)最长为42个中文字符，128个英文字符联系人contact_$n否String(20)联系人，以方便微信在必要时能联系上商家联系电话contact_phone_$n否String(11)联系电话，以方便微信在必要时能联系上商家联系邮箱contact_email_$n否String(60)联系邮箱，以方便微信在必要时能联系上商家3.2.4错误码错误码错误信息说明MICROMCHID_ERROR收款识别码有误，请检查后重试检查收款识别码是否有误WECHATID_ERROR收款人微信号有误，请检查后重试检查收款人微信号是否有误MICROMCHID_WECHATID_NOTMATCH未找到搜索结果，请更换搜索条件后重试收款识别码与收款人微信号都输入，但不匹配SIGNERROR签名错误请检查签名参数和方法是否都符合签名算法要求SYSTEMERROR接口返回错误请尝试再次掉调用API。

3.3下载付款账单API服务商除可通过原有的“下载对账单”接口获取每天的收款明细外，我们还提供“下载付款账单”接口，解决服务商和下挂收款个人的对账问题注意：1、下载‘付款账单’，bill_type固定传“PAYMENT”2、微信在次日9点启动生成前一天的对账单，建议服务商10点后再获取3、对账单中涉及金额的字段单位为“元”3.3.1接口URLhttps:///pay/downloadbill是否需要证书不需要3.3.2请求参数字段名变量名必填类型说明服务商公众账号ID appid是String(32)微信分配的服务商公众账号ID 服务商商户号mch_id是String(32)微信支付分配的服务商商户号平台商户号sub_mch_id是String(32)微信侧提供的固定平台商户号随机字符串nonce_str是String(32)随机字符串，不长于32位签名sign是String(32)签名，详见签名生成算法付款账单日期bill_date是String(8)下载付款账单的日期，格式：20140603账单类型bill_type是String(8)付款账单固定传“PAYMENT”3.2.3返回结果字段名变量名必填类型说明返回状态码return_code是String(16)SUCCESS/FAIL此字段是通信标识，请求是否成功需要查看result_code来判断返回信息return_msg否String(128)返回信息，如非空，为错误原因签名失败；参数格式校验错误；该日期订单未生成；成功时，数据以文本表格的方式返回，第一行为表头，后面各行为对应的字段内容：表头格式为（付款时间,交易账单日期,收款识别码,店铺名称,应结算订单总金额,退款总金额,手续费总金额,付款总金额,付款入账单号,零钱入账说明）从第二行起，为数据记录，各参数以逗号分隔，参数前增加`符号，为标准键盘1左边键的字符，字段顺序与表头一致。

合集下载

微信现金红包API文档

微信现金红包API文档

现金红包API文档修订时间版本号维护人维护内容1前言1.1业务介绍微信红包是微信支付推出的一款基于微信客户端的免费服务应用，微信红包以微信支付为核心安全保障，为广大用户提供安全，快捷的移动支付服务。

春节期间，微信红包以其独特的魅力，优秀的用户体验和安全的支付环境，一经推出即受到了广大用户的热烈欢迎，有效的推动了用户对于移动支付业务的认识。

1.2微信红包发送规则1.2.1发送频率规则1.2.1.1 每分钟发送红包数量不得超过1800个；1.2.1.2 北京时间0：00-8：00不触发红包赠送；（如果以上规则不满足您的需求，请发邮件至wxhongbao@获取升级指引）1.2.2红包规则1.2.2.1 单个红包金额介于[1.00元，200.00元]之间；1.2.2.2 同一个红包只能发送给一个用户；（如果以上规则不满足您的需求，请发邮件至wxhongbao@获取升级指引）1.3商户调用微信红包接口流程1.3.1微信红包接口调用流程后台API调用：待进入联调过程时与开发进行详细沟通；告知服务器：告知服务器接收微信红包的用户openID，告知服务器该用户获得的金额；从商户号扣款：服务器获取信息后从对应商户号的可用余额中扣除对应的金额； 调用失败：因不符合发送规则，商户号余额不足等原因造成调用失败，反馈至调用方； 发送成功：以微信红包公众账号发送对应红包至对应用户；发送成功用户领取从商户号扣款是否符合条件 告知服务器后台API 调用调用失败NY1.3.2确保可用余额充足发放现金红包将扣除商户的可用余额，请注意，可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。

查看可用余额、充值、提现请登录微信支付商户平台（https:///），进入“资金管理”菜单，进行操作。

1.4用户交互流程调用现金红包接口，发放成功后，用户领取红包流程如下：步骤（一）：收到领取红包消息，根据用户微信版本不同，分为：1）微信版本在6.1及以上的用户收到企业自身微信号（调用接口时传入appid对应的商户号）下发领取消息；如果用户未关注微信号，那么会收到由“服务通知”下发的消息2）微信版本在6.1以下的用户仍按原流程收取消息：由微信红包公众号下发领取消息步骤（二）：点击领取消息，拆红包1.5接口列表业务接口简介现金红包发放红包用于企业向微信用户个人发现金红包目前支持向指定微信用户的openid发放指定金额红包。

【微信公众号支付】收货地址共享接口文档V1.4

【微信公众号支付】收货地址共享接口文档V1.4

收货地址共享接口文档V1.41 收货地址共享简介1.1 功能简介微信收货地址共享，是指用户在微信浏览器内打开商品H5 网页，填写过地址，后续支持快速选择免填写，也可增加和编辑。

此地址为用户属性，可在商户网页中共享使用。

支持原生控件填写地址，地址数据会传递到商户后台。

1.2 功能支持地址共享是基于微信JS API 实现，只能在微信内置浏览器中使用，其他浏览器调用无效。

同时，需要微信5.0 版本才能支持，建议通过user agent 来确定用户当前的版本号后再调用地址接口。

以iPhone 版本为例，可以通过user agent可获取如下微信版本示例信息："Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)AppleWebKit/534.46(KHTML,like Geocko) Mobile/9B206MicroMessenger/5.0"其中5.0 为用户安装的微信版本号，商户可以判定版本号是否高于或者等于5.0。

1.3 地址格式微信地址共享使用的数据字段包括：- 收货人姓名- 地区，省市区三级- 详细地址- 邮编- 联系电话其中，地区对应是国标三级地区码，如“广东省-广州市-天河区”，对应的是510630。

详情参考：HYPERLINK"/tjbz/xzqhdm/t20130118_402867249.html"2 公众号收货地址JS API 接口定义2.1 编辑并获取收货地址公众号编辑收货地址editAddress参数列表说明：addrSign 的生成规则如下。

参与addrSign 签名的字段包括：appId、url（当前网页url）、timestamp、noncestr、accessToken（用户授权凭证，请参照oauth2.0 协议获取）。

这里scope、signType 并不参与签名。

对所有待签名参数按照字段名的ASCII 码从小到大排序（字典序）后，使用URL 键值对的格式（即key1=value1&key2=value2…）拼接成字符串string1。

【微信支付】微信被扫支付接口文档V2.5.6

【微信支付】微信被扫支付接口文档V2.5.6


接口调用时序图 1.2 1.2接口调用时序图
微信被扫支付接口文档 V2.5 3
1.3 免密额度
用户使用每单免密额度（用户不可调整） ； � � � � � � 每单小于300元的消费都免密； 每天10次免密刷卡限制； 大于300元的消费需要验证密码； 当天满10次免密，后续交易均验证密码，第二天自动恢复免密次数； 用户行为异常需要验证密码； 用户可以停用此功能；
2. API 说明
2.1 提交被扫支付 API
URL: https:///pay/micropay
具体的post数据格式如： <xml> <appid>wx2421b1c4370ec43b</appid> <attach><![CDATA[att]]></attach> <auth_code>100000000749880164</auth_code> <body><![CDATA[交易说明]]></body> <device_info>1000</device_info> <goods_tag></goods_tag> <mch_id>10000100</mch_id> <nonce_str>58ef9df15219a07d73b176b3e664d735</nonce_str> <out_trade_no>1404470527</out_trade_no> <spbill_create_ip>127.0.0.1</spbill_create_ip> <time_expire></time_expire> <time_start></time_start> <total_fee>1</total_fee> <sign><![CDATA[F06C8D0D931B360AB6DEFB886F8E9FC5]]></sign> </xml> 提交参数说明：
基于微信个人收款码的支付接口的实现与源码

基于微信个人收款码的支付接口的实现与源码

基于微信个⼈收款码的⽀付接⼝的实现与源码前⾔如果我们希望为⾃⼰的⽹站增添微信扫码收款功能，⽤于收取⼀些服务费⽤，为个⼈⽹站提供⾃动化有偿服务的话，那我们有哪些⽅案呢？⾸先，我们先看下效果，以下是服务端的收款⼆维码的发起⽰例演⽰：其次，我们再看看⼿机端微信扫码⽀付的演⽰：我们⼿机端会将收款的消息推送到服务器API。

其中接⼝信息定义⼤概如下：{"title":"微信⽀付","time":"2020-05-08 23:34:11","money":"0.80","deviceid":"mydevice","content":"[2条]微信⽀付: 微信⽀付收款0.80元(朋友到店)"} 以上视频是让⼤家有个效果感观，下⾯我们将详细讲解具体实现原理与细节。

如果您对本专题有兴趣，可以按照下⾯的思路实现。

同时，您也可以在⽂章结尾处查看获取源码的⽅法供⽤于学习研究⽤途的完整源码ZIP。

源码ZIP包括：⼀、主源码-服务端Api （基于.net core webapi，⽤于处理⽀付逻辑）⼆、前端基于boostrap的发起⼆维码扫码界⾯UI三、Android Apk 源码 (java，⽤于监控⼿机消息)四、apk （编译完成可⽤的apk, 如果你不熟悉android，可以直接⽤这个已经编译好的apk ）API处理源码⽰例如下，using System;using System.Linq;using System.Linq.Expressions;using System.Collections.Generic;using Microsoft.AspNetCore.Mvc;using Microsoft.AspNetCore.Authorization;using Lyn.Pay.Api.Domain;using Lyn.Pay.Api.Utils;using Lyn.Pay.Api.DAL;namespace Lyn.Pay.Api.Controllers{/// <summary>/// 控制器/// </summary>[Route("v1/[controller]/[action]")]public class PayController : Controller{//https:///stulzq/snowflake-netprivate static Snowflake.Core.IdWorker worker = new Snowflake.Core.IdWorker(1, 1);public PayController(){}#region 业务应⽤[HttpPost][AllowAnonymous]public JsonResult QueryAlreadyBuy([FromBody]AddOrderVo vo){var remoteUserIp = HttpContext.Connection.RemoteIpAddress.MapToIPv4().ToString();var userIp = vo.IP.HasValue() ? vo.IP : remoteUserIp;//检查这个IP是否已经购买过此⽂章了var alreadyBuy = Service.QueryAny("SELECT 1 FROM [ORDER] d WHERE d.TradeProduct = @TradeProduct AND d.IP = @IP AND d.TradeStatus=1 ", new { TradeProduct = vo.ProductName, IP = userIp });if (alreadyBuy){return Json(Result.Fail(ResultCode.AlreadyBuy));}else{return Json(Result.Fail(ResultCode.Fail));}}/// <summary>/// 产⽣新⽀付订单/// </summary>/// <param name="vo">订单</param>/// <returns>列表数据</returns>[HttpPost][AllowAnonymous]public JsonResult AddOrder([FromBody]AddOrderVo vo){var remoteUserIp = HttpContext.Connection.RemoteIpAddress.MapToIPv4().ToString();var userIp = vo.IP.HasValue() ? vo.IP : remoteUserIp;//检查这个IP是否已经购买过此⽂章了var alreadyBuy = Service.QueryAny("SELECT 1 FROM [ORDER] d WHERE d.TradeProduct = @TradeProduct AND d.IP = @IP AND d.TradeStatus=1 ", new { TradeProduct = vo.ProductName, IP = userIp });if (alreadyBuy){return Json(Result.Fail(ResultCode.AlreadyBuy));}var money = 0;var sqlGetValidMoney = @"SELECT TOP 1 * FROM Product p WHERE (p.[NAME]=@ProductName OR p.[NAME]='Gobal') AND NOT EXISTS(SELECT 1 FROM [ORDER] d WHERE (d.TradeProduct = p.[NAME] OR p.[NAME]='Gobal') AND d.TradeMoney = p.Money AND d.TradeStatus=0) ORDER BY p.IsGobal ASC , p.Money ASC";var r = new Order();//先将过期的更新为过期状态Service.Execute("UPDATE [ORDER] SET TradeStatus=3,ModifyTime=GETDATE() WHERE TradeStatus=0 AND datediff(ss,CreateTime,GETDATE())>120", null);var p = Service.QuerySingle<Product>(sqlGetValidMoney, new { ProductName = vo.ProductName });if (p != null){r.Id = worker.NextId();long.TryParse(r.Id.ToString().Substring(1), out long shortid);r.Id = shortid;r.TradeNo = r.Id.ToString();// vo.TradeNo;r.TradeProduct = vo.ProductName;r.TradeMoney = p.Money;r.TradeStatus = 0;r.Remark = remoteUserIp;r.IP = userIp;r.City = vo.City;r.CreateTime = DateTime.Now;Service.Execute("INSERT INTO [ORDER](Id,TradeNo,TradeProduct,TradeMoney,Remark,IP,City,TradeStatus,CreateTime)VALUES(@Id,@TradeNo,@TradeProduct,@TradeMoney,@Remark,@IP,@City,@TradeStatus,@CreateTime , new { Id = r.Id, TradeNo = r.TradeNo, TradeProduct = r.TradeProduct, TradeMoney = r.TradeMoney, Remark = r.Remark, IP = r.IP, City = r.City, TradeStatus = r.TradeStatus, CreateTime = r.CreateTime });money = p.Money;}if (money > 0){return Json(Result.Success(new { TradeNo = r.Id, Money = money , MoneyYuan = money/100.0, PayQRCode = $"/PayQRCode/{money}.jpg" }));}else{return Json(Result.Fail(ResultCode.Fail));}}/// <summary>/// 产⽣新⽀付订单/// </summary>/// <param name="vo">订单</param>/// <returns>列表数据</returns>[HttpPost][AllowAnonymous]public JsonResult DiscardOrder([FromBody]DiscardOrderVo vo){//先将过期的更新为过期状态Service.Execute("UPDATE [ORDER] SET TradeStatus=3,ModifyTime=GETDATE() WHERE TradeStatus=0 AND datediff(ss,CreateTime,GETDATE())>120", null);var d = Service.QuerySingle<Order>("SELECT * FROM [ORDER] WHERE TradeNo = @TradeNo", new { TradeNo = vo.TradeNo });if (d != null && d.TradeStatus == 0){Service.Execute("UPDATE [ORDER] SET TradeStatus=2,ModifyTime=GETDATE() WHERE TradeStatus=0 AND TradeNo = @TradeNo", new { TradeNo = vo.TradeNo });return Json(Result.Success());}return Json(Result.Fail());}/// <summary>/// 查询订单/// </summary>/// <param name="vo">订单</param>/// <returns>列表数据</returns>[HttpPost][AllowAnonymous]public JsonResult QueryOrder([FromBody]DiscardOrderVo vo){var d = Service.QuerySingle<Order>("SELECT * FROM [ORDER] WHERE TradeNo = @TradeNo", new { TradeNo = vo.TradeNo });if (d != null && d.TradeStatus == 1){return Json(Result.Success());}return Json(Result.Fail());}[HttpPost][AllowAnonymous]public JsonResult PayNotify([FromBody]PayNotifyVo vo){if (vo.title.IndexOf("微信⽀付")>=0 && vo.money.HasValue()){//{"title":"微信⽀付","time":"2019-06-19 21:45:23","money":"0.10","encrypt":"0","deviceid":"ffffffff-c818-83fb-ffff-ffffbbd87511","content":"微信⽀付收款0.10元(朋友到店)"}var moneyFen = Convert.ToInt32(decimal.Parse(vo.money) * 100);Service.Execute("UPDATE [ORDER] SET TradeStatus=1,ModifyTime=GETDATE() WHERE TradeStatus=0 AND TradeMoney = @TradeMoney", new { TradeMoney = moneyFen }); }if (vo.title.IndexOf("微信收款助⼿")>=0){//{ "title":"微信收款助⼿","time":"2019-06-20 22:24:54","money":"null","deviceid":"ffffffff-c818-83fb-ffff-ffffbbd87511","content":"[店员消息]收款到账0.01元"}var content = vo.content;var money = content.Substring(content.IndexOf("收款到账"), content.IndexOf("元") - content.IndexOf("收款到账")).Replace("收款到账", "");var moneyFen = Convert.ToInt32(decimal.Parse(money) * 100);Service.Execute("UPDATE [ORDER] SET TradeStatus=1,ModifyTime=GETDATE() WHERE TradeStatus=0 AND TradeMoney = @TradeMoney", new { TradeMoney = moneyFen }); }return Json(Result.Success());}#endregion}}下图是⽀付回调的发起与结果的接收⽰例：细节原理请仔细往下看.....作为⼀名程序员，我们或多或少都希望建⽴⾃⼰的个⼈技术⽹站、技术博客等等，⽤于记录⾃⼰的汗⽔点滴。