126｜微信支付：安装微信支付模块 koa3-wechat

在微信小程序的全栈开发过程中，集成微信支付功能是提升用户体验、实现商业变现的重要一环。本章节将详细介绍如何在基于Koa3框架的服务器项目中安装并配置koa3-wechat模块，以实现微信支付的集成。koa3-wechat是一个专为Koa3框架设计的微信开发库，它封装了微信支付的API调用细节，使得开发者能够更便捷地在Node.js环境下处理微信支付相关的业务逻辑。

一、准备工作

在开始之前，请确保你的开发环境已经安装了Node.js和npm（Node Package Manager），并且已经创建了一个基于Koa3的服务器项目。此外，你还需要在微信公众平台注册账号，并开通微信支付功能，获取必要的API密钥、商户ID（MCHID）、商户API密钥（APIv3密钥）、商户证书等信息。

二、安装koa3-wechat模块

在你的Koa3项目根目录下，打开终端或命令行工具，执行以下npm命令来安装koa3-wechat模块及其依赖：

npm install koa3-wechat --save

此命令会将koa3-wechat及其所有依赖项添加到你的项目package.json文件的dependencies部分，并下载到node_modules目录中。

三、配置微信支付参数

安装完koa3-wechat后，你需要在你的Koa3应用中配置微信支付的相关参数。这通常涉及到设置商户ID、API密钥、商户证书等敏感信息。为了安全起见，建议不要在代码中直接硬编码这些敏感信息，而是通过环境变量或配置文件来管理。

以下是一个简化的配置示例，假设你已将敏感信息存储在环境变量中：

const Koa = require('koa');
const WechatPay = require('koa3-wechat').WechatPay;
const fs = require('fs');
const app = new Koa();
// 读取商户证书（假设为PEM格式）
const merchantCert = fs.readFileSync('/path/to/your/merchant_cert.pem');
const merchantPrivateKey = fs.readFileSync('/path/to/your/merchant_private_key.pem');
// 微信支付配置
const wechatPayConfig = {
    appid: process.env.WECHAT_APPID, // 小程序AppID
    mchid: process.env.WECHAT_MCHID, // 商户号
    serialNo: process.env.WECHAT_SERIAL_NO, // 商户API证书序列号
    privateKey: merchantPrivateKey.toString(), // 商户私钥
    certs: [
        {
            serialNo: process.env.WECHAT_SERIAL_NO,
            cert: merchantCert.toString(), // 商户证书内容
        }
    ],
    v3Key: process.env.WECHAT_APIV3KEY, // APIv3密钥
    notifyUrl: 'https://your-domain.com/wechatpay/notify', // 微信支付异步通知地址
};
// 初始化微信支付模块
const wechatPay = new WechatPay(wechatPayConfig);
// 接下来，你可以使用wechatPay对象来调用微信支付的API

注意：上述代码中的证书路径、环境变量名称等需根据实际情况调整。

四、实现支付功能

配置好微信支付模块后，你就可以开始实现具体的支付功能了。这通常包括生成预支付交易会话标识（prepay_id）、处理支付结果通知等步骤。

4.1 生成预支付交易会话标识

用户在小程序端发起支付请求时，后端需要生成一个预支付交易会话标识（prepay_id），并将其返回给小程序端。小程序端使用这个prepay_id来调起支付界面。

async function createPrepayId(orderInfo) {
    try {
        const result = await wechatPay.unifiedOrder({
            body: orderInfo.body,
            out_trade_no: orderInfo.out_trade_no,
            total_fee: orderInfo.total_fee,
            spbill_create_ip: orderInfo.spbill_create_ip,
            notify_url: wechatPayConfig.notifyUrl,
            trade_type: 'JSAPI', // 小程序支付类型
            openid: orderInfo.openid, // 用户openid
        });
        return result.prepay_id;
    } catch (error) {
        console.error('Create prepay_id failed:', error);
        throw error;
    }
}
// 假设在某个路由中调用此函数
app.use(async ctx => {
    if (ctx.path === '/api/createPrepayId') {
        const orderInfo = {
            // ... 填充订单信息
        };
        const prepayId = await createPrepayId(orderInfo);
        ctx.body = { prepayId };
    }
});

4.2 处理支付结果通知

微信支付完成后，微信服务器会向商户服务器发送支付结果通知。商户服务器需要验证通知数据的真实性和完整性，并据此更新订单状态。

app.use(async ctx => {
    if (ctx.path === '/wechatpay/notify') {
        // 验证通知数据的真实性和完整性
        // ...（此处省略验证逻辑）
        // 假设验证通过，处理订单逻辑
        const xmlData = ctx.request.body; // 假设已解析为XML对象
        // 根据xmlData中的信息更新订单状态
        // 回复微信服务器，表示通知已处理
        ctx.body = '<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg></xml>';
        ctx.type = 'text/xml';
    }
});

注意：实际开发中，支付结果通知的验证逻辑较为复杂，包括签名验证等，这里仅作简化说明。

五、总结

通过本章节的学习，你应该已经掌握了如何在Koa3项目中安装并配置koa3-wechat模块以实现微信支付功能。这包括准备工作、安装模块、配置微信支付参数、实现支付功能等步骤。在实际开发中，你还需要根据业务需求调整和优化代码，确保支付流程的顺畅和安全。

此外，微信支付还提供了丰富的API接口和文档，支持多种支付场景和支付方式。建议深入阅读微信支付官方文档，以充分利用微信支付的功能和优势。