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 判断
}
})
完整开发流程
支付不是纯前端任务,必须配合服务端完成。标准流程如下:
- 创建订单:前端将商品信息、金额等传给业务服务端,创建待支付订单。
-
服务端统一下单:服务端调用微信支付「统一下单」API,获取
prepay_id,并按照微信要求生成前端所需的timeStamp、nonceStr、paySign等参数,返回给前端。 -
前端调起支付:调用
uni.requestPayment,传入上一步的参数,弹出微信支付窗口。 - 异步通知(关键):用户支付成功后,微信服务器会异步通知你的服务端。服务端必须以此通知为准来更新订单状态,而不能仅依赖前端支付成功的回调。
- 前端确认结果:前端支付成功后,可引导用户查看订单,或主动查询服务端该订单的最终状态。
关键注意事项
不要在前端存储密钥:商户号、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)配置错误或未正确处理回调
|
- 上一篇:Vue3 表单开发的 3 个小建议
- 下一篇:无