开发文档

Telegram Stars 余额、支付与订阅

从客户端角度理解 Stars 余额、支付结果、退款和订阅,不把充值成本与可提现收入混为一谈。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 余额、交易与收益分开看
  2. 支付流程需要最终确认
  3. 订阅有续费与到期状态
  4. 账务实现建议

余额、交易与收益分开看

Stars 余额、交易历史、收益统计和可提现金额由不同字段或方法表达。账号、Bot 与频道的查询权限也不同。客户端应以当前回应和配置为准,不能把一个固定美元换算值当成永久到账承诺。

支付流程需要最终确认

发票、支付表单、提交与支付完成是不同阶段。Stars 使用 XTR,退款关联原始付款标识。本文介绍 MTProto 客户端侧;Bot 服务端收款另见 Bot 支付接入。

订阅有续费与到期状态

订阅会在约定周期扣费,取消、余额不足、到期和已付周期内访问具有不同含义。仅离开频道不一定等于取消订阅,应使用明确的订阅管理动作。

账务实现建议

用整数或协议规定的金额类型存储,始终保留币种。将支付流水、权益发放和退款分别记账,通过唯一付款标识防止重复履约。用户界面清楚显示本次金额、续费周期和取消方式;不从聊天中的“已付款”文本推断真实到账。