Skip to content

03 · Stars 虚拟币支付

用于拉起 Telegram 原生收银台,扣除 Stars 并安全下发商品。


双轨接入方式

Track A — 预制体积木工作流

  1. 打开 03_StarsPayment_Demo 演示场景。
  2. FastTMA_StarsPayButton 拖入 Canvas 或商城货架面板下。
  3. 选中按钮,在 Inspector 中配置 TelegramStarsButton 参数:
字段说明
Product Id商品唯一标识符(如 vip_pass_tier1
Title收银台标题,最多 32 字(如 30天 VIP 通行证
Description商品描述,最多 255 字
Stars Price扣除 Stars 数量(如 50
  1. 履约绑定:在组件底部的 On Purchase Success (String) 事件槽中点击 +,拖入道具发放脚本(如 BagManager),从下拉菜单中选择奖励发放方法。

Track B — 非侵入式组件挂载

  1. 在商业项目中选择现有自定义购买按钮(保留原有动画与材质)。
  2. 点击 Add Component → TelegramStarsButton
  3. 将原 Button OnClick 中的发放方法移除,绑定到 TelegramStarsButtonOnPurchaseSuccess 事件槽。

运行时逻辑:点击后组件自动完成:

  • 向步骤 2 部署的 Cloudflare Worker 请求发票链接
  • 拉起原生 Telegram 收银台
  • 支付确认后触发道具发放函数

演示参考

完整演示实现请参见 Packages/com.fasttma.core/Samples/03_StarsPayment