微信支付之小程序支付

微信的支付方式有以下几种，不同的支付方式适用于不同的支付场景，而今天要给大家讲的就是 小程序支付 方式

说到支付功能就要涉及到金钱交易，必定是有比较严格的规范及流程，如要求小程序必须具备企业性质，必须拥有微信支付商户平台的账号

PS：申请微信支付商户平台需要一个微信小程序或公众号等，建议按照以下流程进行操作

准备工作

1、申请微信小程序账号

申请成功可拿到 AppID（小程序 id）和 AppSecret（小程序密钥）
申请类型为企业性质，否则无法接入微信支付

2、微信小程序认证

通过认证的小程序才能接入微信支付和绑定商户平台

3、申请商户平台账号

需要第一步申请的 AppID
申请成功可拿到 MchID（商户 id）和 MchKey（商户密钥）

4、信小程序关联商户号

微信和商户都认证成功后，在微信后台微信支付菜单中进行关联

5、接入微信支付

在微信后台微信支付菜单中进行接入

小程序支付流程

简要支付流程如下：

1. 用户发起支付请求
2. 后端调用统一下单接口得到 prepay_id
3. 把支付所需参数返回前端
4. 前端调用支付接口进行支付操作
5. 支付结果通知
6. 前端根据不同的支付结果给用户不同的提示

PS：难点在第 2、3、5 步，一定要仔细查看相关接口文档，否则容易出错，接下来我们按照以上 6 个步骤详细讲解在微信小程序中的支付流程

支付前的操作

因为严格意义上来说这不属于支付流程中的步骤，但支付过程中需要用到用户唯一标识openid，所以建议在用户进入小程序时就进行这一步的操作

1. 调用wx.login()接口获取 code，并把code传到服务器
2. 后端服务器拿到 code 后调用code2Session 接口获取 openid 和 session_key
   建议把openid存入数据库，方便随时获取，下面的步骤也会用到
3. 后端服务器保好 appid, secret, mch_id, mch_key（这些数据分别在小程序后台和商户平台中获得，我是把它们做成 commonjs 模块并保存在config/wx.js文件中以方便调用）

PS：开发者需要自行维护用户登录状态（用户登录状态的维护本文不做展开，请自行查阅相关资料）

1、小程序端：用户向商户服务器发起支付请求

这步没什么好说的，当用户点击支付按钮时，给我们自己的后端接口发起一个请求，携带必要的参数（如：body,total_fee 等），接口地址需要自行编写，如我的接口地址为/payment/order

// http对象为wx.request()的二次封装
import http from "../utils";
?
// 向后端发请请求
const res = await http.post("/payment/order", {
  body: "腾讯QQ-购买会员", // 商品描述
  total_fee: 998, // 总金额，单位为分
});
if (res.status === 200) {
  try {
    // 得到接口返回的数据，向微信发起支付
    const result = await wx.requestPayment({
      ...res.data,
    });
    wx.showToast({
      title: "支付成功",
    });
    console.log("支付结果：", result);
  } catch (err) {
    wx.showToast({
      title: "支付失败",
    });
  }
}

PS：可能会有小伙伴产生疑惑，为什么不直接通过 wx.requestPayment() 在小程序端发起请求而要先请求商户自己的服务器呢？原因很简单，安全性问题，wx.requestPayment()需要 2 个重要参数paySign和package，需要 appid,secret,openid,mch_key 等私密数据，这些私密的数据不应该在前端暴露出来，而是放在自己的服务器中更安全，所以需要向自己的服务器发起这个请求拿到这些参数，下一步才能真正发起支付。接下来我们来看看后端是如果操作的

2、商户后端服务器：签名+生成预支付标识

后端代码使用 egg 框架（基于 NodeJS+Koa）实现，文中涉及到 egg 用法和 koa 的用法不再额外说明，请自行查阅相关资料

调用统一下单接口获取 预支付会话标识 prepay_id

注意：该接口需要发送 xml 格式参数，同时返回 xml 格式数据，需自行转换（我使用的是xml-js第三方模块）

• 该接口必填参数：appid，mch_id，nonce_str，sign_type，body，out_trade_no，total_fee，spbill_create_ip，notify_url，trade_type，sign，其中 sign 为前面所有参数加密后的字符

  async order(ctx) {
      // egg框架写法
      const { service, request } = ctx;

      // 获取前端传入参数
      const { userid, total_fee, body } = request.body;

      // 引入微信配置参数（上面准备工作中保存的config/wx.js文件，包含小程序id，密钥，商户id，商户密钥）
      const { config } = require("../../config/wx");

      // 生成订单号（保证唯一性：我采用时间戳拼6位随机数的方式）
      const tradeNo = Date.now() + '' + randomCode(100000, 999999);

      // 统一下单签名参数
      const orderParams = {
          appid: config.appid, // 小程序id
          mch_id: config.mch_id, // 商户id
          nonce_str: service.wx.randomStr(), // 自定义生成随机字符方法
          sign_type: "MD5", // 加密类型
          body, // 商品简单描述，有格式要求
          out_trade_no: tradeNo, // 订单号
          total_fee, // 单位：分
          spbill_create_ip: "121.34.253.98", // 服务器ip
          notify_url: "https://你的服务器域名/payment/wxnotify", // 支付成功通知地址
          trade_type: "JSAPI", // 支付方式（小程序支付选JSAPI）
          openid: user.openid, // 用户openid，步骤0保存的数据
      };

      // 签名：对上面所有参数加密（签名算法请查看接口文档，下同）
      const orderSign = service.wx.sign(orderParams);

      // json->xml
      const xmlData = convert.js2xml(
          { xml: { ...orderParams, sign: orderSign } },
          { compact: true }
      );

      // 调用统一下单接口（接口没说明，但必须为post请求）
      const { data } = await ctx.curl(
          "https://api.mch.weixin.qq.com/pay/unifiedorder",
          {
          method: "post",
          data: xmlData,
          }
      );

      // xml->js
      const result = convert.xml2js(data, { compact: true });

      if (result.prepay_id) {
          // 此处可以把订单信息保存到数据库

          // 返回prepay_id后，接着就是把参数返回前端
          // =>为了更清晰，我把这里的代码写在下一步
          // ...
      }
  }

3、给前端返回支付参数+签名

    // 支付签名参数
    const payParams = {
      appId: config.appid, // 商户 id
      timeStamp: Date.now(), // 时间戳
      nonceStr: this.randomStr(), // 随机字符
      package: "prepay_id=" + result.prepay_id, //预支付会话标识（格式为：prepay_id=统一下单接口返回数据）
      signType: "MD5", //签名类型（必须与上面的统一下单接口一致）
    };
    // 签名
    const paySign = service.wx.sign(payParams);
?
    // 把参数+签名返回给前端
    ctx.body = formatData({
      data: {
        timeStamp: payParams.timeStamp,
        nonceStr: payParams.nonceStr,
        package: payParams.package,
        signType: payParams.signType,
        paySign,
      },
    });

附上封装好的签名方法sign()和生成随机字符串的方法randomStr()，我写在service/wx.js

    "use strict";
    const { Service } = require("egg");
    const crypto = require("crypto");
    // 微信基本配置
    const { weapp } = require("../../config/wx");
    class wxService extends Service {
      randomStr(len = 24) {
        const str =
          "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
        let result = "";
        for (let i = 0; i < len; i++) {
          result += str[Math.floor(Math.random() * str.length)];
        }
        return result;
      }
      sign(data, signType = "MD5") {
        const keys = [];
        for (const key in data) {
          if (data[key] !== undefined) {
            keys.push(key);
          }
        }
        // 字典排序=>key=value
        const stringA = keys
          .sort()
          .map((key) => `${key}=${decodeURIComponent(data[key])}`)
          .join("&");
        // 拼接商户key
        const stringSignTemp = stringA + "&key=" + weapp.mch_key;
        console.log("stringSignTemp", stringSignTemp);
        // 加密
        let hash;
        if (signType === "MD5") {
          hash = crypto.createHash("md5");
        } else {
          hash = crypto.createHmac("sha256", "laoxie");
        }
        hash.update(stringSignTemp);
        const paySign = hash.digest("hex").toUpperCase();
        return paySign;
      }
    }
    module.exports = wxService;

4、小程序端：向微信服务器发起请求

第 1 步的数据返回后，向微信服务器接口wx.requestPayment()发请求，唤起支付界面，请查看第一步 try...catch 中的代码

5、微信服务器：支付结果通知

在第 2 步向统一下单接口发起请求时附带了一个notify_url，此地址一定要是可外网访问的接口地址（商户自行编写），由微信服务器调用该接口，不管支付成功与否，此接口都会调用，并返回相应数据（查看接口数据），所以商户可以在此接口中编写相关业务逻辑、如支付成功后写入数据库等操作

注意：商户需要在此接口中做接收处理，并向微信服务器返回应答（按接口规范返回特定数据）。如果微信收到商户的应答不是成功或超时，微信会认为通知失败，微信会通过一定的策略定期重新发起通知，通知频率为：15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h，但微信不保证通知最终一定能成功。

  "use strict";
?
  const Controller = require("egg").Controller;
  const getRawBody = require("raw-body");
  const contentType = require("content-type");
  const { formatData, randomCode, params, formatParams } = require("../utils");
?
  class PaymentController extends Controller {
    // 微信支付回调地址
    async notify(ctx) {
      const { req } = ctx;
?
      // 微信调用该接口时传入的数据为xml,所以先转换
      const data = await getRawBody(req, {
        length: req.headers["content-length"],
        limit: "1mb",
        encoding: contentType.parse(req).parameters.charset,
      });
      const result = params.xml2js(data);
?
      // 验签：微信传入的除sign外的所有数据进行签名，拒后与sign进行对比是否一致
      // 一致说明支付成功，否则支付失败
      // 并根据不同的结果通知微信服务器（响应不同的xml数据，如下）
      const resultSign = result.sign;
      delete result.sign;
      const mySign = ctx.service.wx.sign(result);
      console.log("sign:", resultSign, mySign);
?
      ctx.set("content-type", "text/plain");
?
      if (resultSign === mySign) {
        // 修改商户订单状态
        const {
          device_info,
          openid,
          trade_type,
          bank_type,
          total_fee,
          settlement_total_fee,
          fee_type,
          transaction_id,
          time_end,
          attach,
        } = result;
?
        // 格式化自定义参数
        let myattach = {};
        if (attach) {
          myattach = params.parse(attach);
        }
?
        // 格式化支付时间：20200423161017=>2020/04/23 16:10:17
        let pay_time = time_end.replace(
          /(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/,
          "$1/$2/$3 $4:$5:$6"
        );
        pay_time = new Date(pay_time);
?
        // 根据订单号更新数据库中的订单状态
        const newData = {
          device_info,
          openid,
          trade_type,
          bank_type,
          total_fee,
          settlement_total_fee,
          fee_type,
          transaction_id,
          pay_time,
          status: 1,
          ...myattach,
        };
        db.update(
          "purchase",
          {
            out_trade_no: result.out_trade_no,
          },
          {
            $set: newData,
          }
        );
?
        ctx.body = `<xml>
            <return_code><![CDATA[SUCCESS]]></return_code>
            <return_msg><![CDATA[OK]]></return_msg>
          </xml>`;
      } else {
        ctx.body = `<xml>
            <return_code><![CDATA[FAIL]]></return_code>
            <return_msg><![CDATA[ERROR]]></return_msg>
          </xml>`;
      }
    }
  }
?
  module.exports = PaymentController;

附上以上代码中会用的封装好的方法parse()、xml2js()、js2xml()，我写在utils/index.js中

  const params = {
    parse(queryString) {
      // 'a=1&b=2' => {a:1,b:2}
      return queryString.split("&").reduce((res, item) => {
        const arr = item.split("=");
        res[arr[0]] = arr[1];
        return res;
      }, {});
    },
    js2xml(data) {
      return convert.js2xml({ xml: data }, { compact: true });
    },
    xml2js(xml) {
      const result = convert.xml2js(xml, {
        compact: true,
        textKey: "value",
        cdataKey: "value",
      }).xml;
      const data = {};
      for (const key in result) {
        data[key] = result[key].value;
      }
      return data;
    },
  };
  module.exports = {
    params
  }

到此微信支付之小程序支付就完成了，过程比较繁杂，一定要一步步去实现，也许会踩坑，但相信我，这是每个程序员的必经这路，面对它，勇敢地走过去，你对能到达胜利的彼岸。

注意事项

• appid、appsecret、mchid、mchkey、openid 为小程序或商户私密信息，应保存在服务端
• 注意参数大小写：每个接口大小写可能不同
• 签名算法：请查看接口文档
• 一定要注意看文档，根据我多冷踩坑的经历，90%以上的问题都是没有仔细看文档所致

参考网址与接口

• 微信支付商户平台：https://pay.weixin.qq.com
• 微信公众平台：https://mp.weixin.qq.com
• 微信支付接口：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/payment/wx.requestPayment.html
• 统一下单接口：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_1
• 支付结果通知接口：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_7&index=8
• 签名算法：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=4_3

[mp] https://mp.weixin.qq.com

[pay] https://pay.weixin.qq.com

[payment] https://developers.weixin.qq.com/miniprogram/dev/api/open-api/payment/wx.requestPayment.html

[notify] https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_7&index=8

[login] https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html

[unifiedorder] https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_1

[code2session] https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html

[sign] https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=4_3