> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram 支付通知

> 在 StablePay Portal 中自助配置 Telegram Bot 通知，让团队在群组中接收实时支付提醒。

Telegram 支付通知允许商家在 StablePay Portal 中自助配置 Telegram Bot，并将支付提醒发送到自己的 Telegram 群组中。

这项能力适合希望让运营、客服、财务或风控团队更快感知支付状态变化的场景，尤其适用于需要人工跟单、人工复核或高频关注异常支付的业务。

<Card title="前往 Telegram 通知设置" icon="paper-plane" href="https://merchant.stablepay.co/#/settings/telegram-notifications">
  打开 StablePay Portal 的 Telegram 通知设置页，直接开始配置 Bot Token 和群组绑定。
</Card>

## 适合什么时候使用

建议在以下场景启用：

* 你希望团队在 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](https://t.me/BotFather) 创建 Telegram Bot
* 你已经创建好一个用于接收通知的 Telegram 群组，或准备在配置过程中创建

## 如何配置

### 步骤 1：通过 BotFather 创建 Telegram Bot

每个 Telegram Bot 都需要由 `@BotFather` 颁发 API Token。

1. 打开 Telegram，搜索 [@BotFather](https://t.me/BotFather)
2. 发送 `/newbot`
3. 设置一个 Bot 显示名称，例如 `stablepay bot`
4. 设置一个唯一用户名，并以 `bot` 结尾，例如 `stablepay1bot`
5. 复制 BotFather 返回的 API Token

<Warning>
  Bot Token 属于敏感凭证。请妥善保管，不要泄露给无关人员，也不要提交到公开代码仓库。
</Warning>

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

进入 [Telegram 通知设置页](https://merchant.stablepay.co/#/settings/telegram-notifications)，将刚刚复制的 Bot Token 填入输入框并保存。

<Frame>
  <img src="https://static.stablepayfi.ai/tele_1.PNG" alt="Telegram 通知设置页 - 填写 Bot Token" />
</Frame>

保存成功后，页面会生成一条属于该 Bot 的绑定指令，用于后续将 Telegram 群组与当前商户账户绑定。

<Frame>
  <img src="https://static.stablepayfi.ai/tele_2.PNG" alt="Telegram 通知设置页 - 已绑定群组" />
</Frame>

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

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

绑定成功后，你可以在商户后台看到已绑定的群组 ID 和群组名称。

至此，商户 Telegram 支付通知配置完成。

## 配置完成后你能获得什么

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

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

## 通知效果示例

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

<Frame>
  <img src="https://static.stablepayfi.ai/tele_0.PNG" alt="Telegram 群组中的支付通知效果示例" />
</Frame>

## 重要说明

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

## 相关页面

* [开始使用](/zh/product/Get-Started)
* [稳定币收银台](/zh/product/Stablecoin-Checkout)
* [支付链接](/zh/product/Payment-Links)
* [账单收款](/zh/product/Invoicing)
* [品牌设置](/zh/product/Branding-Settings)