☰ 首页

最近使用

0
暂无使用记录,点击左侧工具开始使用

VUE3在UNI-APP下微信小程序支付开发指南

在 Vue3 + uni-app 下开发微信小程序支付,核心是理解 前端仅负责调起支付,真正的下单、签名、回调处理必须在服务端完成。前端使用 uni.requestPayment,并传入服务端返回的支付参数即可。

前端调起支付

微信小程序支付的前端调用相对简洁,uni.requestPayment 所需的参数与微信原生 wx.requestPayment 基本一致。

核心 API 参数:

参数 类型 必填 说明
provider String 是 固定值 wxpay
timeStamp String 是 时间戳(秒级)
nonceStr String 是 随机字符串
package String 是 统一下单接口返回的 prepay_id 参数值,格式如 prepay_id=xxx
signType String 是 签名算法,通常为 MD5 或 RSA
paySign String 是 签名

Vue3 组合式 API 示例:

// 假设从服务端获取到了支付参数 payParams
const payParams = await getPayParamsFromServer(orderId) 

uni.requestPayment({
  provider: 'wxpay',
  timeStamp: payParams.timeStamp,
  nonceStr: payParams.nonceStr,
  package: payParams.package,
  signType: payParams.signType,
  paySign: payParams.paySign,
  success: (res) => {
    console.log('支付成功', res)
    // 建议:这里不要直接认为订单已完成,应跳转到订单详情页或轮询服务端确认最终状态
  },
  fail: (err) => {
    console.error('支付失败或取消', err)
    // 用户取消支付也会进入 fail 回调,可根据 err.errMsg 判断
  }
})

完整开发流程

支付不是纯前端任务,必须配合服务端完成。标准流程如下:

  1. 创建订单:前端将商品信息、金额等传给业务服务端,创建待支付订单。
  2. 服务端统一下单:服务端调用微信支付「统一下单」API,获取 prepay_id,并按照微信要求生成前端所需的 timeStamp、nonceStr、paySign 等参数,返回给前端。
  3. 前端调起支付:调用 uni.requestPayment,传入上一步的参数,弹出微信支付窗口。
  4. 异步通知(关键):用户支付成功后,微信服务器会异步通知你的服务端。服务端必须以此通知为准来更新订单状态,而不能仅依赖前端支付成功的回调。
  5. 前端确认结果:前端支付成功后,可引导用户查看订单,或主动查询服务端该订单的最终状态。

关键注意事项

不要在前端存储密钥:商户号、API 密钥、证书等敏感信息只能存放在服务端。前端代码(即使是打包后的)不应包含任何可用于签名的密钥。

处理支付结果:uni.requestPayment 的 success 回调仅代表用户完成了支付动作。务必以服务端收到的微信异步通知(或主动查询微信订单状态)为准,防止用户端网络异常导致状态不同步。

区分小程序支付与虚拟支付:如果你开发的是短剧、知识付费等虚拟内容类小程序,微信强制要求使用「虚拟支付」,对应的 API 是 uni.requestVirtualPayment,而非 uni.requestPayment。普通实物电商或线下服务仍使用标准微信支付。

考虑使用 uni-pay(可选):如果你的项目使用 uniCloud,官方提供了 uni-pay 云端一体方案,封装了微信、支付宝等多端支付逻辑,可以简化服务端签名、回调处理等重复工作,减少出错概率。纯原生开发或已有独立后端则无需引入。

常见失败原因排查

现象 可能原因
requestPayment:fail 参数错误 检查 timeStamp 是否为字符串格式的秒级时间戳;package 是否包含 prepay_id= 前缀
签名错误 服务端签名算法有误,或签名使用的参数与前端传入的不完全一致(注意大小写、空值处理)
支付窗口未弹出 检查 manifest.json 中微信小程序 AppID 是否正确配置;确认当前小程序类目支持微信支付
支付成功但订单未更新 服务端异步通知地址(notify_url)配置错误或未正确处理回调