Telegram Bot Stars 支付完全指南：數位商品、訂閱與 Bot API 整合場景

如果你經營一個 Telegram Bot，並希望在不依賴第三方支付平台的情況下，向用戶銷售數位商品或提供付費訂閱，那麼 Telegram Bot Stars 支付 是一個值得關注的官方方案。Stars 是 Telegram 推出的虛擬貨幣，用戶透過官方管道購買後，可在 Bot 內用於解鎖內容、購買虛擬道具或訂閱服務。本文將從 Bot API 整合角度，詳解 Stars 支付的適用場景、實作步驟與限制，並與 Stripe/USDT 等外部 SaaS 支付方案進行比較，協助你規劃最合理的支付策略。

什麼是 Telegram Bot Stars 支付？

Telegram Stars（又稱「星星」）是 Telegram 官方推出的虛擬貨幣，用戶可在應用程式內購買（透過 App Store、Google Play 或 Fragment 等管道），然後在支援 Stars 的 Bot 中消費。Stars 支付透過 Bot API 整合：開發者需在 BotFather 中啟用 Payments 並選擇「Telegram Stars」作為支付提供方，然後呼叫 sendInvoice 方法發送發票。

簡單來說，Stars 支付讓 Bot 開發者無需自建支付系統或接入 Stripe/PayPal 等外部平台，即可實現小額、即時、用戶信任度高的數位商品交易。但請注意：Stars 僅限於數位商品（如電子書、會員、虛擬道具），不可用於實體商品或線下服務。

Stars 支付的適用場景

Stars 支付適合以下典型場景：

• 數位內容解鎖：用戶支付 Stars 後，Bot 自動發送 PDF、課程連結、影片或音訊檔案。
• Bot 內訂閱：如進階通知、去廣告、專屬數據分析報告。注意：Stars 支付不支援自動扣款，需 Bot 端手動續訂。
• 虛擬道具購買：遊戲內物品、表情包、頭像框等。
• 付費功能：進階搜尋、批次處理、API 存取權限等。

不支援：實體商品、外送/叫車等線下服務、兌現為法幣（需透過官方兌換管道）。

Stars 支付的優勢與局限性

優勢	局限性
用戶信任度高（官方支付管道，無需輸入信用卡號）	僅限數位商品
無需外部支付平台，整合簡單	無法直接兌現為法幣（需兌換 TON 或透過第三方）
即時到帳，用戶支付後 Bot 立即收到通知	不支援自動退款爭議處理
Telegram 抽成透明（詳見官方文件）	不適合大額交易或長期訂閱週期管理

如何透過 Bot API 整合 Stars 支付？

整合 Stars 支付的核心步驟（基於 Bot API 6.9+）：

1. 在 BotFather 中啟用 Payments：傳送 /mybots → 選擇你的 Bot → 「Payments」 → 選擇 「Telegram Stars」 作為提供方。
2. 呼叫 sendInvoice 方法：參數包括 title、description、payload（自訂資料）、currency（必須設為 "XTR"）、prices（Stars 整數，如 [{"label": "电子书", "amount": 10}]）。
3. 處理回呼：監聽 pre_checkout_query（預結算查詢，需呼叫 answerPreCheckoutQuery 確認）和 successful_payment（支付成功，即可解鎖商品）。

偽代碼範例（Python 風格）：

# 发送发票
bot.send_invoice(
    chat_id=user_id,
    title="高级会员 - 7天",
    description="解锁所有高级功能",
    payload="premium_7d_001",
    currency="XTR",
    prices=[{"label": "会员", "amount": 50}]
)

# 处理成功支付
@bot.on_successful_payment()
def on_payment(payment):
    user_id = payment.from_user.id
    # 记录用户有效期，解锁功能
    grant_premium(user_id, days=7)

Stars 支付的典型應用：數位商品與 Bot 內訂閱

數位商品

用戶支付 Stars 後，Bot 自動發送檔案、連結或解鎖功能。例如：

• 用戶發送 /buy_ebook，Bot 發送 10 Stars 的發票。
• 支付成功後，Bot 發送 PDF 下載連結（或直接在聊天中發送檔案）。
• 邏輯簡單，無需狀態管理，適合單次購買。

Bot 內訂閱

Stars 支付不支援自動扣款，因此訂閱需透過 Bot 端手動續訂：

• 用戶支付 Stars 購買 7 天會員，Bot 記錄到期時間（如 expire_at）。
• 到期前，Bot 發送提醒訊息和續費發票。
• 用戶再次支付後，Bot 延長有效期。

這種模式適合輕量級訂閱（如週/月會員），但不適合需要自動續費、分級定價或團隊管理的複雜場景。

Stars 支付 vs. 外部 SaaS 訂閱（Stripe/USDT）——如何分工？

對於同時營運數位商品和長期訂閱的團隊，合理分工能提升效率：

對比維度	Stars 支付	外部 SaaS（如 TG-Staff 的 Stripe/USDT）
適用商品	數位商品、小額即時購買	大額交易、自動續費訂閱
支付方式	Telegram 內購（Stars）	信用卡、USDT（TRC20）
自動續費	不支援（需手動續訂）	支援（Stripe 自動扣款）
退款處理	不支援自動退款	支援退款、發票管理
合規審計	無內控功能	支援內容風控（如錢包地址監控）
多專案管理	單 Bot	多 Bot、多坐席權限控制

何時選擇 Stars 支付？

• 商品單價低（如 1–50 Stars，約 0.1–5）。
• 用戶量級小，無需退款機制。
• Bot 功能簡單，僅需單次解鎖。
• 範例：付費解鎖 Bot 表情包、單次數據分析報告。

何時選擇外部 SaaS 支付？

• 商品單價高（如 $20+），或需要自動續費。
• 多席位協作、合規監控（如 TG-Staff 的內容風控，可檢測席位是否誤發錢包地址）。
• 需要退款與發票管理。
• 範例：TG-Staff 專業版訂閱（含無限翻譯、用戶畫像、內控管理）。

實施 Stars 支付時的注意事項

1. Stars 提現：需透過 Telegram 官方合作夥伴（如 Fragment）兌換為 Toncoin（TON），再轉為法幣。注意匯率波動與手續費。
2. 退款政策：Stars 支付不支援自動退款。建議在 Bot 商品描述中明確退換貨規則，並保留交易日誌，以便手動處理爭議。
3. 用戶教育：部分用戶可能不熟悉 Stars 購買流程。Bot 內需提供引導，如「如何購買 Stars？」按鈕連結至官方幫助頁。
4. API 限制：sendInvoice 有頻率限制（官方未公開具體數值），高頻場景（如搶購）需設計佇列或限流。

常見問題

問：Telegram Stars 可以提現為法幣嗎？
答：可以。Telegram 官方提供 Stars 兌換為 Toncoin（TON）的渠道，也可透過部分第三方合作夥伴兌換為法幣。具體匯率和手續費以官方公告為準。

問：Stars 支付支援訂閱自動續費嗎？
答：不支援自動扣款。Stars 支付是一次性發票，開發者需透過 Bot 端邏輯（如記錄有效期）手動發送新發票實現續訂。自動續費場景建議使用 Stripe 等外部支付。

問：Stars 支付的手續費是多少？
答：Telegram 對 Stars 支付收取一定比例手續費（通常在 5%–30% 之間，具體取決於商品類型和地區）。建議在定價時預留利潤空間。

問：我可以用 Stars 支付購買 TG-Staff 套餐嗎？
答：不可以。TG-Staff 目前僅支援 Stripe 和 USDT（TRC20）支付，不接入 Telegram Stars。Stars 支付適用於 Bot 內數位商品，而 TG-Staff 是外部 SaaS 平台。

問：如果用戶退款，Stars 能退回嗎？
答：Stars 支付不支援自動退款。開發者需自行聯繫用戶協商，並透過 Bot 邏輯手動處理（如重新發放商品或補償 Stars）。建議在 Bot 內明確退款政策。

---

下一步：為你的 Bot 構建完整支付體系

如果你的 Bot 需要同時支援數位商品銷售和長期訂閱管理，不妨組合使用 Stars 支付與外部 SaaS 方案。例如：

• 用 Stars 實現單次內容解鎖。
• 用 TG-Staff（支援 Stripe/USDT）處理月度/年度訂閱，同時利用其會話分流、內容風控（如錢包地址監控）等專業功能，提升團隊效率與合規性。

立即訪問 TG-Staff 官網 了解套餐詳情，或前往 控制台 註冊 3 天免費試用。如有整合問題，可聯繫 客服 Bot 獲取即時幫助。