跳到主要内容

支付状态查询

介绍​

在小程序开发中，支付功能是一个非常重要的模块。用户完成支付后，开发者通常需要查询支付状态，以确保支付成功并更新订单状态。支付状态查询功能可以帮助开发者确认支付是否成功，避免因网络延迟或其他问题导致的支付状态不一致。

本文将详细介绍如何在小程序中实现支付状态查询功能，包括必要的代码示例和实际应用场景。

支付状态查询的基本概念​

支付状态查询是指在小程序支付完成后，通过调用微信支付接口，查询订单的支付状态。通常，支付状态包括以下几种：

  • SUCCESS: 支付成功
  • REFUND: 转入退款
  • NOTPAY: 未支付
  • CLOSED: 已关闭
  • REVOKED: 已撤销
  • USERPAYING: 用户支付中
  • PAYERROR: 支付失败

通过查询支付状态，开发者可以确保支付流程的完整性和可靠性。

实现支付状态查询的步骤​

1. 获取支付订单号​

在用户发起支付请求时，微信支付会生成一个唯一的支付订单号（transaction_id）。开发者需要保存这个订单号，以便后续查询支付状态。

javascript
// 示例：获取支付订单号
const transactionId = '4200000466202001012345678901';

2. 调用微信支付查询接口​

微信支付提供了 orderquery 接口，用于查询支付状态。开发者需要向该接口发送请求，并传入支付订单号。

javascript
// 示例：调用微信支付查询接口
const requestData = {
  appid: 'your-appid',
  mch_id: 'your-mch-id',
  transaction_id: transactionId,
  nonce_str: 'your-nonce-str',
  sign: 'your-signature'
};

wx.request({
  url: 'https://api.mch.weixin.qq.com/pay/orderquery',
  method: 'POST',
  data: requestData,
  success: function (res) {
    console.log('支付状态查询结果:', res.data);
  },
  fail: function (err) {
    console.error('支付状态查询失败:', err);
  }
});

3. 解析查询结果​

微信支付查询接口会返回一个包含支付状态的 XML 或 JSON 数据。开发者需要解析该数据，并根据支付状态更新订单状态。

javascript
// 示例：解析查询结果
const responseData = {
  return_code: 'SUCCESS',
  result_code: 'SUCCESS',
  trade_state: 'SUCCESS',
  trade_state_desc: '支付成功'
};

if (responseData.return_code === 'SUCCESS' && responseData.result_code === 'SUCCESS') {
  if (responseData.trade_state === 'SUCCESS') {
    console.log('支付成功');
    // 更新订单状态为已支付
  } else {
    console.log('支付状态:', responseData.trade_state_desc);
  }
} else {
  console.error('支付状态查询失败:', responseData.return_msg);
}

实际应用场景​

场景 1: 支付成功后的订单状态更新​

在用户完成支付后，开发者可以通过支付状态查询功能确认支付是否成功，并更新订单状态。例如，将订单状态从“待支付”更新为“已支付”。

场景 2: 支付失败后的重试机制​

如果支付状态查询结果显示支付失败，开发者可以提示用户重新发起支付，或者提供其他支付方式。

场景 3: 支付超时处理​

在某些情况下，用户可能因为网络问题导致支付超时。开发者可以通过支付状态查询功能确认支付状态，并根据结果进行相应的处理。

总结​

支付状态查询是小程序支付功能中不可或缺的一部分。通过查询支付状态，开发者可以确保支付流程的完整性和可靠性，避免因支付状态不一致导致的订单问题。

在实际开发中，开发者需要妥善保存支付订单号，并在支付完成后及时查询支付状态。通过合理的错误处理和重试机制，可以进一步提升用户体验。

附加资源​

练习​

  1. 尝试在小程序中实现支付状态查询功能，并处理不同的支付状态。
  2. 设计一个支付超时处理机制，确保用户在支付超时后能够重新发起支付。
  3. 研究微信支付的其他接口，了解如何实现退款功能。