← 返回首页📘 帮助中心

帮助中心

商户注册、登录与控制台功能完全指南

🚀快速开始

注册商户

进入登录页切换到「注册商户」标签，依次填写：

  • 社群名称：仅用于展示
  • Bot Token：找 @BotFather⧉ 创建 Bot 后获得，格式如 123456:ABC-DEF⧉
  • 目标群 ID：把 Bot 拉进群后获取，多种获取方式见下方常见问题「」
  • 默认支付通道：后续可在控制台修改

提交后系统会校验 Token 有效性，并一次性展示三个支付通道的 Webhook 回调地址，以及：

💡API Key 是商户后台唯一凭证，请立即保存，关闭后不再显示！

登录控制台

在登录页粘贴注册时保存的 API Key 即可进入控制台。

💡API Key 是商户后台的唯一身份凭证，请勿泄露；如怀疑泄露，请联系平台重置。

每次登录浏览器会记住 Key，下次无需重复输入。

把 Bot 配置进群

① 拉 Bot 进群：将你的 Bot 拉入付费群并设为管理员（需要「邀请用户」与「封禁成员」权限）。

② 绑定 Webhook：复制控制台「」页展示的 TG Webhook 地址，在浏览器访问下面的地址完成绑定（替换尖括号占位符）：

https://api.telegram.org/bot<你的Token>/setWebhook?url=<Webhook地址>&secret_token=<控制台显示的密钥>

③ 验证购买菜单：群内用户私聊 Bot 发送 /start⧉ 即可看到购买菜单。

🎛️控制台功能

仪表盘

展示当前商户的核心经营指标：

  • 活跃 / 宽限期订阅数
  • 订阅者总数
  • MRR（月度经常性收入，按套餐周期归一化计算）
  • 最近订单流水分页列表

套餐管理

创建与管理阶梯套餐：名称（展示在 Bot 购买按钮上）、价格（最小货币单位，如美分）、计费周期（月/季/年）、Stars 定价（可选，通道为 Stars 时使用）、排序权重与上下架开关。

保存后立即同步到 Bot 的 /start⧉ 购买菜单与 Mini App 商城。

接入配置

商户的「总设置面板」：

  • 查看 Bot 信息与三个 Webhook 地址
  • 配置各支付通道密钥（Stripe Secret Key / Webhook 密钥、Lemon Squeezy API Key / 店铺 ID / 签名密钥、NOWPayments IPN 密钥）
  • 切换默认支付通道
  • 配置柔性催缴（挽回链接与优惠券文案）

分销管理

开启二级分销并设定一/二级佣金比例（如 20%/5%）。页内可查看：分销员排行（按佣金余额）、全部佣金记录、提现申请列表。

对 REQUESTED⧉ 状态的提现可执行「通过打款」或「驳回」（驳回自动退还余额给申请人）。

群发广播

按受众圈选定向群发：

  • ACTIVE⧉ 活跃订阅
  • PAST_DUE⧉ 宽限期
  • CHURNED⧉ 已流失（含已取消与已过期）

填写文案后创建活动，系统经消息队列异步逐条投递（约 30 条/秒），活动详情页可查看每个接收人的发送状态与失败原因。

数据分析

三张经营报表：

  • Cohort 留存：按月分组的新增订阅者随月份的留存率矩阵
  • LTV 概览：累计营收、付费用户、ARPU、复购率、月度营收柱状
  • 退订原因分布：用户退订时选择的原因聚合

Mini App 商城

官方 Mini App 内嵌的用户端商城页面：展示套餐列表、发起购买（自动路由到商户默认通道）、自助退订。

使用 Telegram initData⧉ 签名校验身份，无需额外登录。控制台可查看 Mini App 访问地址。

💳支付通道配置

Stripe（信用卡，推荐海外用户使用）

在 Stripe 后台创建密钥：

  1. API Key 填入「」的 Stripe Secret Key
  2. Webhook 签名密钥（whsec_⧉ 开头）填入对应栏位
  3. 在 Stripe Dashboard 添加 Webhook 端点，指向控制台展示的 Stripe Webhook 地址

需要订阅的事件：

checkout.session.completed
invoice.payment_succeeded
customer.subscription.deleted

周期扣款由 Stripe 托管订阅自动完成。

Lemon Squeezy

在 Lemon Squeezy 后台获取 API Key、Store ID 与签名密钥填入「」；Webhook 端点指向控制台展示的 LS Webhook 地址。

系统按订单使用 custom_price⧉ 动态创建结算链接，无需预建商品。

Telegram Stars（站内币）

无需任何密钥，套餐设置 Stars 定价后即可通过 Bot 内购（sendInvoice⧉）收款。

适合希望留在 Telegram 生态内的小额订阅，平台到账为 Stars，提现遵循 Telegram 官方规则。

加密货币（NOWPayments：USDT/TON/BTC）

注册 NOWPayments 获取 API Key 与 IPN 签名密钥填入「」；Webhook 端点指向控制台展示的 NOWPayments 地址。

用户付款后链上确认自动触发开通。

❓常见问题

API Key 丢了怎么办？

💡API Key 仅在注册成功时展示一次。

若遗失，请联系平台管理员核实身份后重置；重置后旧 Key 立即失效。

用户付款了但没进群？

按顺序排查：

  1. Bot 是否在目标群里且为管理员（必须有「邀请用户」权限）
  2. TG Webhook 是否已通过 setWebhook⧉ 正确绑定（secret_token⧉ 是否一致）
  3. 控制台仪表盘是否出现该笔订单——有订单说明支付链路正常，重点检查 Bot 权限

为什么支付成功扣了两次款？

系统有三层幂等保护（Redis 标记、事件唯一索引、订单状态防重），重复的支付通知只会入账一次。

若用户侧显示重复扣款，通常是支付平台侧的重复扣款指令，可在支付平台后台核对并退款。

如何更换目标群？

在「」页更新目标群 ID（或联系平台修改），把 Bot 拉入新群并授予管理员权限即可。

历史订阅数据保留，不影响续费。

佣金什么时候可以提现？

订单支付成功后佣金即时计入推广人余额。

用户在 Bot 内发送 /payout⧉ 发起提现申请，商户或平台管理员审批通过后按申请中填写的收款方式打款；驳回则金额自动退回余额。

支持哪些语言？

商户控制台与用户端 Bot 消息均支持中文/英文：控制台跟随浏览器语言（右上角可手动切换）；Bot 根据用户的 Telegram 客户端语言自动选择中英文文案。

如何获取群 ID？

把 Bot 拉入目标群后（普通群发一条消息），任选其一：

  1. 官方 API（推荐，无需第三方）：在浏览器访问下面的地址（替换成你的 Token），在返回的 JSON 中找到 chat⧉ 对象的 id⧉ 字段：
https://api.telegram.org/bot<你的Token>/getUpdates
  1. 第三方小工具：把 @getidsbot⧉ 或 @userinfobot⧉ 拉进群（或把群里的消息转发给它），即可读到群 ID
  2. Telegram 网页版：打开 web.telegram.org⧉ 进入该群，地址栏 #-100xxxxxxxx⧉ 中「#」后的数字（含负号）即为群 ID
💡超级群 ID 以 -100⧉ 开头，普通群以 -⧉ 开头；填入注册表单时请带上完整负号。

还有其他问题？

联系平台管理员或在社群内 @你的 Bot 反馈。

进入控制台← 返回首页