Node.js 微信扫码支付功能实现详解

作者:慢半拍时间:2026-10-22 12:39:52浏览:341

本文详细记录在 Node.js 环境下实现微信扫码支付的完整流程。涵盖从获取 AppID、商户号及密钥等准备工作,到使用模式二进行统一下单、生成二维码,再到通过轮询查询订单状态及处理异步回调通知的关键步骤。重点解析签名算法、XML 数据解析及防止重复支付等常见坑点,为开发者提供实战参考。

前言

本文旨在整理本人在开发微信扫码支付功能时遇到的实际问题与解决方案,供同行参考借鉴,希望能对正在经历类似开发过程的开发者有所帮助。

开发环境

  • Node.js v8.1.0
  • Egg.js v1.1.0

准备工作

首先需要获取微信公众号的 AppID。

其次需要注册并获取微信商户号(mch_id)。

最后配置 API 密钥(Key),这是一个用于签名算法的 32 位密码。可通过微信商户平台(pay.weixin.qq.com)的“账户设置”->“API安全”->“密钥设置”路径进行配置,也可使用 MD5 生成一个符合要求的密钥。

扫码支付-统一下单

此处采用微信支付的模式二,因其流程相对简单。


  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}&notify_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.js 的请求方式,若使用原生 Node.js,可替换为 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 两个关键字段。将这两个值返回给前端,由前端生成二维码供用户扫码,从而完成支付发起流程。

监听支付是否成功

完成上述操作后,需确认用户是否已完成支付。由于用户可能停留在展示二维码的页面,我们需要在用户付款后通知其支付结果。

具体做法是:在用户发起支付生成二维码的同时,前端开启定时器,定期向后端发送查询请求。后端需提供查询订单接口,接收前端传来的 out_trade_no(即系统内部订单号),并据此调用微信查询接口 https://api.mch.weixin.qq.com/pay/orderquery。该流程与统一下单类似,但接口地址及返回的 XML 字段不同。返回状态包含 SUCCESS(支付成功)和 NOTPAY(未支付)。后端根据状态判断结果并返回给前端,若支付成功则提示用户并关闭前端的定时器。

回调地址

这是一个关键环节。尽管上述流程可处理大部分情况,但存在特殊场景:例如用户电脑断网无法发送轮询请求,但手机端已完成付款。此时若无可信的通知渠道,系统将无法记录支付信息。因此,设置回调地址至关重要。

设置回调地址

需在微信商户中心 -> 产品中心 -> 开发配置 -> 扫码支付 页面中配置回调地址。

后端需使用 POST 方法接收微信发送的异步回调信息。注意,回调数据格式为 XML,若后端框架默认不支持解析 XML,可能会接收到空数据,需额外配置以支持 XML 接收。

在保存用户支付信息前,务必先查询该订单是否已支付。这是为了防止因网络延迟或重复通知导致重复操作,进而产生多条支付记录。

总结

微信扫码支付的开发过程中存在一些易错点,初次摸索时请特别注意以下事项:

  1. 必须正确编写签名算法,否则接口调用将失败。确保所有参数拼接顺序和格式正确。
  2. 微信返回的数据均为 XML 格式,需借助插件将其转换为 JSON,以便在代码中方便地获取和处理数据。
  3. 返回的 code_url 需交由前端生成二维码展示给用户。同时,后端需配合前端开启定时器查询订单状态,最终将支付结果通知用户。
  4. 回调地址配置非常重要。后端需通过 POST 接收微信的异步回调信息并保存。在保存支付信息前,必须检查订单是否已存在支付记录,以避免重复添加。此外,后端需确保能正确接收 XML 格式的回调数据,这通常需要额外的配置支持,否则可能无法获取正常数据。
作者最新文章