更新记录

3.0.3（2026-06-07）

代币充值 — 支持多档位代币包，微信虚拟支付链路（wx.requestVirtualPayment） 代币消耗 — 余额查询、扣减、退款，完整闭环 道具内购 — 道具购买、查询已购、退款（当前标记关闭，可随时开启）

技术特点：

覆盖充值/消耗/退款/管理全链路 纯云函数架构，uniCloud（阿里云/腾讯云）均可部署

平台兼容性

云端兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

云星支付Pro v3.0

微信虚拟支付 uniCloud 插件 — 单云函数全功能架构。

功能

• 道具内购（虚拟支付）：uniCloud 自动托管微信支付回调，下单→支付→发货全链路
• 权益包（订阅类商品）：支持按期购买，堆叠到期时间
• 金币充值/消费：米大师金币集成，充值、查询余额、消费流水
• 退款：支持按剩余比例退款，自动回滚配额
• 配额管理：日/月/总量三层限制，原子条件更新防并发超卖
• 管理后台接口：商品管理、订单查询、数据统计

环境要求

• uniCloud (阿里云/腾讯云) >= 2.0.0
• 微信小程序 (mp-weixin)
• 已开通微信虚拟支付 (米大师)
• 已配置 uniCloud 微信支付

快速接入

1. 部署云函数

将 uniCloud/cloudfunctions/yunxingpay-pro/ 上传到 uniCloud。

2. 配置环境变量

在 uniCloud 控制台 → 云函数 → yunxingpay-pro → 环境变量 中配置：

跨后台术语对照详见 过审指南。

3. 初始化商品

云函数首次调用自动写入默认商品到 settings 集合。也可通过管理接口 adminAddProduct 新增自定义商品。字段：

{
  "key": "month",
  "name": "月度权益包",
  "amount": 2999,
  "coins": 0,
  "type": "membership",
  "duration": 30
}

4. 前端调用

uni-app 项目：

import YXP from './yunxingpay-pro/client.js'
const yxp = new YXP({ cloudFunctionName: 'yunxingpay-pro' })

// 道具支付（SDK 自动获取 session_key，无需手动处理）
await yxp.pay('month')

// 金币充值
await yxp.buyCoins('coin_60')

// 查询金币余额
await yxp.queryBalance()

原生微信小程序：

const YXP = require('./yunxingpay-pro/js_sdk/client-wechat.js')
const yxp = new YXP({
  baseUrl: 'https://xxx.service.tcloudbase.com/yunxingpay-pro',
  openid: wx.getStorageSync('openid')
})

// 支付（SDK 自动 wx.login 获取 code，失败自动重试）
await yxp.pay('month')

API 清单（26+ 个接口，24 个 SDK 方法）

完整接口说明见 API-EXAMPLES.md。

定价

需多 AppID 授权请线下联系。

注意事项

• 云函数自动获取 openid / session_key，前端无需手动传入
• 管理接口均需传 _secret 参数
• 米大师密钥通过云函数环境变量配置，不硬编码
• 退款接口默认按比例退款，不可退情况返回友好提示

售后

• 技术支持：提交工单或联系开发者
• 版本更新：购买源码版可获后续更新
• 文档：见 API-EXAMPLES.md