前言
本篇文章主要是记录本人在微信扫码支付过程中所遇到的问题, 给大家一个借鉴作用, 希望对你们有帮助
开发环境
- nodejs v8.1.0
- egg v1.1.0
准备工作
微信公众号 - appid
微信商户号 - mch_id
key 值 (签名算法所需, 其实就是一个 32 位的密码, 可以用 md5 生成一个)(key 设置路径: 微信商户平台(pay.weixin.qq.com)--> 账户设置 -->API 安全 -->密钥设置)
扫码支付 - 统一下单
以下才用的是微信模式二, 因为比较简单
- let MD5 = require('md5'),
- xml2js = require('xml2js'),
- url = "https://api.mch.weixin.qq.com/pay/unifiedorder",// 下单请求地址
- appid = '公众号 id',
- mch_id = '微信商户号';
- notify_url = '回调地址',
- out_trade_no = '自己设置的订单号',// 微信会有自己订单号我们自己的系统需要设置自己的订单号
- total_fee = '订单金额',// 注意, 单位为分
- body = '商品简单描述',
- trade_type = 'NATIVE',// 交易类型, JSAPI-- 公众号支付 NATIVE-- 原生扫码支付 APP--app 支付
- nonce_str = moment().format('YYYYMMDDHHmmssSSS'),// 随机字符串 32 位以下
stringA = `appid=${公众号 id}&body=${body}&mch_id=${微信商户号}&nonce_str=${nonce_str}¬ify_url=${
- notify_url}&out_trade_no=${out_trade_no}&spbill_create_ip=${ctx.request.ip}&total_fee=${total_fee}&trade_type=${trade_type}`,
- stringSignTemp = stringA + "&key=xxxxxxxxxxxxxxxxx", // 注: key 为商户平台设置的密钥 key
- sign = MD5(stringSignTemp).toUpperCase(); // 注: MD5 签名方式
以上就是我们所需要的一些参数
签名生成算法见微信官方: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_3
spbill_create_ip 是 终端 ip 地址
下面把所有的参数拼接成 xml
- const formData = "<xml>";
- formData += "<appid>" + appid + "</appid>"; //appid
- formData += "<body>" + body + "</body>"; // 商品或支付单简要描述
- formData += "<mch_id>" + mch_id + "</mch_id>"; // 商户号
- formData += "<nonce_str>" + nonce_str + "</nonce_str>"; // 随机字符串, 不长于 32 位
- formData += "<notify_url>" + notify_url + "</notify_url>"; // 支付成功后微信服务器通过 POST 请求通知这个地址
- formData += "<out_trade_no>" + out_trade_no + "</out_trade_no>"; // 订单号
- formData += "<total_fee>" + total_fee + "</total_fee>"; // 金额
- formData += "<spbill_create_ip>" + ctx.request.ip + "</spbill_create_ip>"; //ip
- formData += "<trade_type>NATIVE</trade_type>"; //NATIVE 会返回 code_url ,JSAPI 不会返回
- formData += "<sign>" + sign + "</sign>";
- formData += "</xml>";
- // 这里使用了 egg 里面请求的方式
- const resultData = yield ctx.curl(url, {
- method: 'POST',
- content: formData,
- headers: {
- 'content-type': 'text/html',
- },
- });
- // xml 转 json 格式
- xml2js.parseString(resultData.data,
- function(err, json) {
- if (err) {
- new Error("解析 xml 报错")
- } else {
- var result = formMessage(json.xml); // 转换成正常的 json 数据
- console.log(result) // 打印出返回的结果
- }
- }) var formMessage = function(result) {
- var message = {};
- if (typeof result === 'object') {
- var keys = Object.keys(result);
- for (var i = 0; i < keys.length; i++) {
- var item = result[keys[i]];
- var key = keys[i];
- if (! (item instanceof Array) || item.length === 0) {
- continue;
- }
- if (item.length === 1) {
- var val = item[0];
- if (typeof val === 'object') {
- message[key] = formMessage(val);
- } else {
- message[key] = (val || '').trim();
- }
- } else {
- message[key] = [];
- for (var j = 0,
- k = item.length; j < k; j++) {
- message[key].push(formMessage(itemp[j]));
- }
- }
- }
- }
- return message;
- }
上面使用了 egg 的请求方式, 原生 node 可以使用 request
- var request = require('request');
- request({
- url: url,
- method: "POST",
- body: formData
- }, function(error, response, body) {
- if (!error && response.statusCode == 200) {
- }
- });
如果请求成功会最终返回一个 xml, 然后我们进行解析成 json 的格式, 里面会有一个 code_url 和 out_trade_no, 我们需要把这两个返回给前端, 然后通过生成二维码展示给用户扫码, 完成支付
监听支付是否成功
上面操作完成之后, 我们需要知道用户是否完成支付, 因为用户会停留在该页面, 我们需要在用户付完款之后, 通知用户支付成功
首先, 用户发起支付的时候我们会生成二维码, 让用户完成扫码支付, 我们还要做的是, 开一个定时器, 每隔一段时间去发送一个请求, 这个时候, 我们 node 后台就需要写一个查询订单的接口, 之前我们拿到了 out_trade_no, 也就是我们系统内部的订单号, 我们把这个数据发送给后台查询订单的接口, 然后后台接收到之后会请求微信的查询接口地址 https://api.mch.weixin.qq.com/pay/orderquery, 流程跟上面一样, 只是接口地址和微信返回的 xml 不一样而已, 返回的字段会有一个状态即 SUCCESS 和 NOTPAY, 我们可以通过判断是否支付返回给前端, 成功之后提示给用户支付成功, 关闭定时器
回调地址
这个是非常重要的一环, 大部分的操作其实在上面就可以完成, 但是有特殊的情况, 比如用户电脑断网发送不了请求, 但是手机付款了, 这就会导致我们记录不到用户支付的信息这个时候回调地址就很重要了
设置回调地址
微信商户中心 ->产品中心 ->开发配置 ->扫码支付
之后我们需要做的是后端用 post 来接收微信发送的异步回调信息, 也是 xml 的格式, 这里注意, 如果不支持接收 xml, 可能会得到空的数据
这里还需要注意的是, 我们在保存用户支付信息的同时, 得先查改订单是否支付, 以免重复操作, 可能会插入多条记录的情况
总结
微信扫码支付坑还是有的, 如果你是第一次摸索的话, 下面罗列一下需要注意的地方
签名算法要写正确, 不然是不会成功的, 要拼接正确才行
微信返回的是 xml 格式的数据, 我们得通过插件转成 json, 这样才方便获取数据
返回的 code_url 要给前端生成二维码用, 然后需要开一个定时器查询该订单是否完成支付, 最终通知用户结果
回调地址很重要, 我们后端需要 post 接收微信返回的回调信息, 然后保存信息, 不过在保存用户支付信息的之前, 我们得知道该订单是否已经保存过, 以免重复添加还有就是返回的是 xml 的数据, 后端一定要保证能够接收得到, 按照正常的方式是接收不了的, 得额外设置
来源: http://www.jb51.net/article/135125.htm