跳到主要内容

微信支付概述

微信支付是腾讯公司推出的一种移动支付方式，广泛应用于微信小程序、公众号、H5 页面等场景。它为用户提供了便捷的支付体验，同时也为开发者提供了丰富的 API 接口，便于集成支付功能。

微信支付的基本概念​

微信支付的核心功能包括支付、退款、查询等。开发者可以通过调用微信支付提供的 API 接口，实现这些功能。微信支付的主要流程如下：

  1. 用户下单：用户在小程序中选择商品并提交订单。
  2. 生成支付订单：小程序后端调用微信支付 API，生成支付订单。
  3. 发起支付：小程序前端调用微信支付接口，发起支付请求。
  4. 支付结果通知：微信支付服务器将支付结果通知到小程序后端。
  5. 支付完成：用户完成支付，小程序显示支付结果。

微信支付的集成步骤​

1. 注册微信支付商户号​

首先，你需要在微信支付平台上注册一个商户号。注册完成后，你将获得一个商户号（mch_id）和一个 API 密钥（key），这些信息将在后续的支付流程中使用。

2. 配置小程序支付权限​

在小程序后台，你需要配置支付权限，并获取小程序的 AppID 和 AppSecret。这些信息将用于生成支付签名。

3. 生成支付订单​

在小程序后端，你需要调用微信支付的统一下单接口（unifiedorder），生成支付订单。以下是一个简单的示例代码：

javascript
const axios = require('axios');
const crypto = require('crypto');

const createOrder = async (params) => {
  const { appid, mch_id, nonce_str, body, out_trade_no, total_fee, spbill_create_ip, notify_url, trade_type, openid } = params;

  const signParams = {
    appid,
    mch_id,
    nonce_str,
    body,
    out_trade_no,
    total_fee,
    spbill_create_ip,
    notify_url,
    trade_type,
    openid,
  };

  const sign = generateSign(signParams, 'your_api_key');

  const requestData = {
    ...signParams,
    sign,
  };

  const response = await axios.post('https://api.mch.weixin.qq.com/pay/unifiedorder', requestData, {
    headers: { 'Content-Type': 'application/xml' },
  });

  return response.data;
};

const generateSign = (params, key) => {
  const sortedParams = Object.keys(params).sort().map(k => `${k}=${params[k]}`).join('&');
  const stringSignTemp = `${sortedParams}&key=${key}`;
  return crypto.createHash('md5').update(stringSignTemp).digest('hex').toUpperCase();
};

4. 发起支付请求​

在小程序前端，你可以使用微信提供的 wx.requestPayment 接口，发起支付请求。以下是一个示例代码：

javascript
wx.requestPayment({
  timeStamp: '时间戳',
  nonceStr: '随机字符串',
  package: '预支付订单号',
  signType: 'MD5',
  paySign: '签名',
  success(res) {
    console.log('支付成功', res);
  },
  fail(err) {
    console.error('支付失败', err);
  },
});

5. 处理支付结果通知​

微信支付服务器会将支付结果通知到你在统一下单接口中指定的 notify_url。你需要在后端处理这些通知，并更新订单状态。以下是一个简单的处理示例：

javascript
const handlePaymentNotification = (req, res) => {
  const { return_code, result_code, out_trade_no, transaction_id } = req.body;

  if (return_code === 'SUCCESS' && result_code === 'SUCCESS') {
    // 更新订单状态
    updateOrderStatus(out_trade_no, 'paid', transaction_id);
    res.send('<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg></xml>');
  } else {
    res.send('<xml><return_code><![CDATA[FAIL]]></return_code><return_msg><![CDATA[FAIL]]></return_msg></xml>');
  }
};

实际案例​

假设你正在开发一个电商小程序，用户可以在小程序中购买商品。当用户选择商品并提交订单后，你需要调用微信支付的统一下单接口生成支付订单，然后在小程序前端发起支付请求。支付成功后，微信支付服务器会将支付结果通知到你的后端服务器，你需要更新订单状态并通知用户支付成功。

总结​

微信支付为小程序提供了便捷的支付解决方案。通过调用微信支付提供的 API 接口，你可以轻松实现支付功能。本文介绍了微信支付的基本概念、集成步骤以及实际案例，希望能帮助你更好地理解和使用微信支付。

附加资源​

练习​

  1. 尝试在你的小程序中集成微信支付功能，并测试支付流程。
  2. 修改支付结果通知处理逻辑，增加日志记录功能。
  3. 研究微信支付的其他功能，如退款、查询等，并尝试实现这些功能。