Telegram 支付通知

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

​

适合什么时候使用

建议在以下场景启用：

• 你希望团队在 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

​

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

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

​

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

1. 创建一个用于接收通知的 Telegram 群组
2. 将刚创建的 Bot 拉入该群组
3. 把商户后台显示的绑定指令发送给机器人
4. 回到商户后台，点击 我已发送

绑定成功后，你可以在商户后台看到已绑定的群组 ID 和群组名称。 至此，商户 Telegram 支付通知配置完成。

​

配置完成后你能获得什么

配置完成后，你的团队可以在 Telegram 群组中实时接收 StablePay 支付通知，并更快处理以下场景：

• 正常收款成功
• 支付失败或支付过期
• 少付和多付订单
• 风控审核中的异常支付

​

通知效果示例

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

​

重要说明

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

​

相关页面

• 开始使用
• 稳定币收银台
• 支付链接
• 账单收款
• 品牌设置