Telegram Bot / Mini App Policy Guide

Telegram 支付政策速查

面向数字商品、数字钱包和加密货币支付场景，整理 Telegram 官方政策、开发者条款和区块链指南。

核心结论Telegram 内数字商品和服务必须使用 Telegram Stars / XTR。

Decision Cards

先判断你的场景

高频问题可以先看这四张卡片；需要引用依据时，再继续阅读下方完整政策章节。

必须

数字商品和服务

必须使用 Telegram Stars / XTR

Bot 或 Mini App 内销售虚拟商品、数字内容、会员权益、在线功能解锁等数字权益时，支付必须走 Stars。

  • currency 使用 XTR
  • 不需要第三方 provider_token
  • 不能用外部钱包、USDT、TON、ETH、BTC 或 Stripe 绕开 Stars
允许

实物商品和现实服务

可以使用第三方支付商

外卖、门票、物流配送商品、线下服务等现实世界商品或服务，可以使用 Telegram Payments 接入支付商。

  • Telegram 不处理支付信息
  • 支付由 payment providers 处理
  • 数字商品不能套用这条规则
有条件

Mini App 钱包和链上功能

基本限定为 TON + TON Connect

Mini App 如果实现钱包连接、签名交易、NFT、Token 分发或链上资产交互，应基于 TON Blockchain 和 TON Connect SDK。

  • 不得推广非 TON cryptoassets 或 wallets
  • 不得引导用户到外部平台使用非 TON 加密资产
  • 其他钱包协议仅在 bridge 到 TON 场景下允许
豁免

普通 Bot 无 Mini App

区块链指南豁免，数字支付规则不豁免

没有 Mini App 组件的普通 Bot 不适用 Mini App 区块链指南，但 Telegram 内数字商品仍必须使用 Stars。

  • 区分数字商品支付规则和区块链集成规则
  • 数字商品支付规则适用于 Bot 和 Mini App
  • 不能把普通 Bot 豁免理解为允许外部加密支付数字商品

Full Reference

完整政策依据

01

数字商品和服务必须使用 Telegram Stars

结论

如果销售的是虚拟商品、数字内容、数字服务、游戏内物品、会员权益、在线功能解锁或 Bot / Mini App 内数字权益，则必须使用 Telegram Stars / XTR。

Telegram 官方 Stars 支付文档要求，Bot 或 Mini App 内的数字商品和服务支付必须 exclusively 使用 Telegram Stars。

实现上，货币字段使用 XTR，数字商品支付不需要第三方 provider_token。用户可以通过 Telegram 内购购买 Stars，再使用 Stars 支付数字商品或服务。

官方 FAQ 明确说明，不能接受加密货币替代 Telegram Stars 来支付 Telegram App 内 Bot 或 Mini App 的数字商品和服务。

  • 不能使用 USDT、TON、ETH、BTC 等加密货币支付数字商品。
  • 不能使用外部钱包、Stripe、信用卡直连、第三方支付商或外部网页支付绕开 Stars。
  • 支付完成后由 Bot 处理 successful_payment 并发放数字权益。
官方来源

02

实物商品和现实服务可以使用第三方支付商

结论

如果销售的是实物商品或现实服务，可以使用 Telegram Payments 接入第三方 payment providers。

Telegram Bot Payments 页面适用于 physical goods and services，而不是数字商品和数字服务。

Telegram 自己不处理支付信息，不保存信用卡信息，也不收取支付佣金；支付由开发者集成的第三方 payment providers 处理。

这条规则不能用于数字商品场景，数字商品仍然必须使用 Telegram Stars。

  • 适用外卖、门票、物流配送商品、线下服务等现实世界交易。
  • 支付方式取决于 payment provider，可能包含信用卡、Apple Pay、Google Pay 等。
  • 如果商品本质是 Telegram 内数字权益，不能用第三方支付商替代 Stars。
官方来源

03

开发者条款禁止数字商品使用替代支付系统

结论

Bot / Mini App 内数字商品和服务交易必须通过 Telegram Stars 完成，替代支付系统可能导致 TPA 被限制或终止。

Telegram Bot Platform Developer Terms of Service 规定，数字商品和服务交易不能通过第三方支付商处理。

条款中的 TPA 指 Third Party Applications，包括 Bots 和 Mini Apps。

即使开发者拥有自己的网站、外部支付页面、自建钱包流程或其他 App 内支付方式，只要销售的是 Telegram 内数字商品或服务，就不能用它们绕开 Stars。

  • 不能把用户导出 Telegram 完成数字商品付款后再回到 Bot 发放权益。
  • 不能用外部钱包或自建支付通道规避 Telegram Stars。
  • 违规后果包含 store versions of Telegram 中不可访问或 Bot Platform 终止。
官方来源

04

Mini App 区块链集成基本必须走 TON + TON Connect

结论

Mini App 如果实现加密货币功能、钱包连接或链上资产交互，应使用 TON Blockchain 和 TON Connect SDK。

Telegram 对 Mini App 的区块链集成有明确限制：加密资产发行或分发必须基于 TON，钱包连接必须通过 TON Connect SDK。

Mini App 不得推广非 TON 的 cryptoassets、wallets 或 multichain wallets，也不得引导或链接用户到推广或使用非 TON 加密资产的外部平台、App 或网站。

其他钱包连接协议只在将资产 bridge 到 TON 的场景下允许。

  • 不应在 Mini App 中用 WalletConnect 普通连接 Ethereum 钱包做签名交易。
  • 不应接入 MetaMask、Solana 钱包或 Bitcoin 钱包用于非 bridge 场景。
  • NFT、Token 分发和链上资产发行应围绕 TON 设计。
官方来源

05

普通 Bot 没有 Mini App 的区块链规则例外

结论

没有 Mini App 组件的普通 Telegram Bot 豁免 Mini App 区块链指南，但数字商品支付仍然必须用 Stars。

Telegram 区块链指南说明，这些规则只适用于 Mini Apps 及其 Telegram 平台上的 bots。

Regular Telegram bots that do not have a Mini App component are exempt。

这个豁免不代表普通 Bot 可以用外部加密支付销售 Telegram 内数字商品。数字商品支付规则仍然适用于 Bot 和 Mini App。

  • 数字商品支付规则：Bot 和 Mini App 都必须使用 Stars。
  • 区块链集成规则：主要约束 Mini App 及其 connected bots。
  • 产品设计时必须先判断交易对象是数字商品还是实物/现实服务。
官方来源

06

外部钱包是否允许要分场景判断

结论

外部钱包不能用于支付 Telegram 内数字商品；Mini App 链上功能则需遵守 TON + TON Connect；多链钱包有额外限制。

用外部钱包支付 Telegram 内数字商品不允许，因为数字商品必须使用 Telegram Stars。

Mini App 连接钱包做链上功能允许，但基本限定为 TON + TON Connect。

Mini App 作为多链钱包管理 BTC、ETH 等资产有条件允许，但操作必须在钱包界面内部完成；如果与外部 app 或 platform 交互，必须通过 TON Connect。

  • 不得内嵌其他链 dApp 目录。
  • 不得链接到外部 app 来管理其他链资产。
  • 不得使用其他钱包连接协议做非 bridge 场景的签名交互。
官方来源

07

对产品设计的实际影响

结论

Telegram 内数字商品支付推荐流程是 Bot 调用 sendInvoice，currency 使用 XTR，用户用 Stars 支付，Bot 收到 successful_payment 后发放权益。

推荐做法是让用户在 Bot 或 Mini App 中选择数字商品，然后由 Bot 调用 sendInvoice，使用 XTR 作为 currency。

Bot 应处理 answerPreCheckoutQuery 和 successful_payment，必要时使用 refundStarPayment。

高风险做法是把用户引导到外部网站连接 MetaMask、Phantom 或 WalletConnect，并用 USDT、ETH、SOL 等支付后再回 Telegram 发放数字商品。

  • 高风险流程同时涉及绕开 Stars、替代支付系统、非 TON 钱包连接和非 TON 资产推广。
  • 实物商品和现实服务可以走 Telegram Payments 的第三方支付商路径。
  • 产品文案和支付入口应避免暗示数字商品可以用外部加密支付。
官方来源