Skip to main content
Telegram 支付通知允许商家在 StablePay Portal 中自助配置 Telegram Bot,并将支付提醒发送到自己的 Telegram 群组中。 这项能力适合希望让运营、客服、财务或风控团队更快感知支付状态变化的场景,尤其适用于需要人工跟单、人工复核或高频关注异常支付的业务。

前往 Telegram 通知设置

打开 StablePay Portal 的 Telegram 通知设置页,直接开始配置 Bot Token 和群组绑定。

适合什么时候使用

建议在以下场景启用:
  • 你希望团队在 Telegram 群中实时看到收款成功、失败或过期提醒
  • 你需要更快关注少付、多付或风险审核中的支付订单
  • 你希望在通知中同步看到商户订单号,方便内部对账和人工处理
  • 你当前主要依赖运营或客服团队跟进支付状态,而不只依赖系统回调

功能说明

当前版本支持 Telegram 群组中的支付相关通知,包括:
  • Payment succeeded notifications
  • Payment failed notifications
  • Payment expired notifications
  • Underpaid and overpaid payment alerts
  • Risk review payment alerts
  • Includes merchant order ID for reconciliation
通知按商户维度隔离。完成绑定后,群组只会接收当前商户账户对应的支付通知。

配置前准备

开始前,请先确认:
  • 你已经拥有可登录的 Telegram 账号
  • 你可以使用 @BotFather 创建 Telegram Bot
  • 你已经创建好一个用于接收通知的 Telegram 群组,或准备在配置过程中创建

如何配置

步骤 1:通过 BotFather 创建 Telegram Bot

每个 Telegram Bot 都需要由 @BotFather 颁发 API Token。
  1. 打开 Telegram,搜索 @BotFather
  2. 发送 /newbot
  3. 设置一个 Bot 显示名称,例如 stablepay bot
  4. 设置一个唯一用户名,并以 bot 结尾,例如 stablepay1bot
  5. 复制 BotFather 返回的 API Token
Bot Token 属于敏感凭证。请妥善保管,不要泄露给无关人员,也不要提交到公开代码仓库。
3c601091 8cb1 4faf 8782 946c6c0f82b8

步骤 2:在商户后台保存 Bot Token

进入 Telegram 通知设置页,将刚刚复制的 Bot Token 填入输入框并保存。 Telegram 通知设置页 - 填写 Bot Token Telegram 通知设置页 - 填写 Bot Token 保存成功后,页面会生成一条属于该 Bot 的绑定指令,用于后续将 Telegram 群组与当前商户账户绑定。 Telegram 通知设置页 - 已绑定群组 Telegram 通知设置页 - 已绑定群组

步骤 3:创建群组并完成绑定

  1. 创建一个用于接收通知的 Telegram 群组
  2. 将刚创建的 Bot 拉入该群组
  3. 把商户后台显示的绑定指令发送给机器人
  4. 回到商户后台,点击 我已发送
绑定成功后,你可以在商户后台看到已绑定的群组 ID 和群组名称。 至此,商户 Telegram 支付通知配置完成。 6553e515 E9e5 470c B53a C6746c14376f

配置完成后你能获得什么

配置完成后,你的团队可以在 Telegram 群组中实时接收 StablePay 支付通知,并更快处理以下场景:
  • 正常收款成功
  • 支付失败或支付过期
  • 少付和多付订单
  • 风控审核中的异常支付

通知效果示例

下面是 Telegram 群组中的通知效果示例,用于帮助你确认配置完成后的最终展示形态。 Telegram 群组中的支付通知效果示例 Telegram 群组中的支付通知效果示例

重要说明

  • 当前文档描述的是商户自助配置流程,不再需要提交开通申请
  • 当前仅支持支付相关事件通知
  • 当前不包含 refunds、subscriptions、payouts、settlements 事件通知
  • 如果你更换了 Bot Token,建议重新检查绑定状态是否正常
  • 这项能力属于可选运营配置,不影响 Checkout、Payment Links、Invoicing 或 API 的正常使用

相关页面

最后修改于 2026年9月2日