更新记录

3.0.6（2026-06-08）

• 新增 YXP_PRODUCT_SECRET 环境变量，商品管理使用独立密钥
• adminAddProduct / adminDelProduct 独立鉴权，可安全授权给运营人员
• 向后兼容：未设 YXP_PRODUCT_SECRET 时自动回退到 YXP_SECRET

3.0.5（2026-06-08）

• 接口扩展至 33 个 action
• 管理鉴权：YXP_SECRET 环境变量 + managementPassword 保护
• 数据库集合增至 6 个，

3.0.4（2026-06-08）

1. 新增授权激活系统，支持按AppID动态授权，含自助激活+管理端发码
2. 修复微信支付session_key缺失问题，支付成功率大幅提升 3.接口扩展至33个action，数据库集合增至6个
3. 优化支付链路，新增登录重试机制

平台兼容性

云端兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用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 清单（40+ 个接口，24 个 SDK 方法）

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

定价

需多 AppID 授权请线下联系。

注意事项

• 云函数自动获取 openid / session_key，前端无需手动传入
• 核心管理接口（授权/统计/订单）需传主密钥 _secret
• 商品管理（adminAddProduct/adminDelProduct）使用独立密钥，可安全开放给运营人员
• 米大师密钥通过云函数环境变量配置，不硬编码
• 退款接口默认按比例退款，不可退情况返回友好提示

售后

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