uni-app怎么使用uni-pay实现云端支付-uni-app-PHP中文网

最省事的uni-app支付方案是uni-pay+uniCloud，但需严格区分前端调起与云端下单：支付参数必须由uniCloud云函数生成并签名，前端仅传参调用uni.requestPayment；微信V3支付需正确配置appId、mchId、v3Key及证书路径；虚拟支付须用uni.requestVirtualPayment并配套uni-pay-co云对象。

uni-app怎么使用uni-pay实现云端支付

直接用 uni-pay + uniCloud 是目前最省事的 uni-app 支付方案，但前提是别把「前端调起」和「云端下单」混为一谈——支付参数必须由服务端生成并签名，前端只负责传参和调用 uni.requestPayment。

uni-pay 云函数必须部署在 uniCloud，不能本地运行

很多开发者本地调试时直接 require('uni-pay')，结果报错 Cannot find module 'uni-pay' 或 crypto not available。这是因为：uni-pay 依赖 Node.js 原生 crypto 模块和 HTTPS 客户端能力，这些在前端或 H5 环境不可用，只能跑在 uniCloud 云函数里。

云函数目录结构要规范：比如 cloudfunctions/getOrderInfo/index.js，且该函数已成功部署到阿里云/腾讯云环境
不能在 pages 或 components 里 import uni-pay，否则编译会失败或运行时报错
uniCloud 项目需启用「云对象」或「云函数」功能，并确保已安装 uni-pay 插件（HBuilderX 插件市场搜索安装，或 npm install uni-pay --save）

微信 V3 支付初始化必须填对四个关键字段

V3 和 V2 的初始化差异极大，填错任意一个都会导致 getOrderInfo 调用返回签名错误、证书加载失败或 401 unauthorized。重点盯住这四个字段：

appId：来自微信公众平台（小程序）或开放平台（App），不是商户平台的
mchId：纯数字字符串，从微信商户平台「账户中心 → 商户信息」里复制，不要带空格或字母
v3Key：32 位 ASCII 字符，必须和商户平台「API安全 → APIv3密钥」里设置的一致，大小写敏感
appCertPath 和 appPrivateKeyPath：必须是 .pem 格式，且路径指向云函数根目录下的实际文件（如 path.resolve(__dirname, './apiclient_cert.pem')），不能是 URL 或 base64 内容

常见错误现象：ERR_CERTIFICATE_REQUIRED 表示证书路径不对；INVALID_SIGNATURE 多半是 v3Key 和商户平台不一致；INVALID_REQUEST 往往因为 appId 用错了环境（比如小程序用了公众号的 appId）。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

前端调用 uni.requestPayment 前必须先请求云函数获取支付参数

uni.requestPayment 不接受原始订单数据，它只认云函数返回的标准化对象。这个对象必须包含 provider、orderInfo（微信）、alipaySign（支付宝）等字段，由 uni-pay 的 getOrderInfo 方法生成。

前端代码示例（不能漏掉 success 和 fail 回调）：

uniCloud.callFunction({
  name: 'getOrderInfo',
  data: { amount: 100, subject: '会员续费' }
}).then(res => {
  const { code, data } = res.result;
  if (code === 0) {
    uni.requestPayment({
      provider: 'wxpay',
      orderInfo: data, // 注意：这里 data 是已签名的完整对象，不是原始订单
      success: () => console.log('支付成功'),
      fail: (err) => console.error('支付失败', err)
    });
  }
});

getOrderInfo 云函数返回的 data 字段，是 uni-pay 封装后可直接喂给 uni.requestPayment 的，不要二次 JSON.stringify 或解构
微信小程序环境下，provider 必须传 'wxpay'；支付宝小程序传 'alipay'；App 端则根据打包渠道自动映射，无需手动指定

虚拟支付（短剧类目）必须用 uni.requestVirtualPayment，且仅限微信小程序

如果你的小程序属于「短剧、小说、漫画」等类目，微信强制要求使用虚拟支付，此时 uni.requestPayment 会直接被拒。必须改用 uni.requestVirtualPayment，且它的参数完全不兼容普通支付。

前端调用时，signData、paySig、signature 都必须由云端通过 uni-pay-co 的 requestWxpayVirtualApi 接口返回，前端不能自行拼接
云函数中不能用 uni-pay 的 getOrderInfo，而要用 uni-pay-co 云对象（需单独引入）调用 createVirtualOrder 等方法
该 API 在 App、H5、支付宝等所有其他平台均不支持，调用会直接报错 not supported