在Telegram生态中，机器人的应用早已超越简单的聊天和群管，越来越多的开发者希望通过机器人实现付费服务、会员订阅或商品销售。而接入支付系统正是完成商业闭环的关键一步。本文将从零开始，手把手教你如何为Telegram机器人接入支付系统，涵盖官方Bot API的支付接口、支付提供商配置、下单确认机制，以及安全风控和常见问题，帮助你快速实现机器人收款功能。
一、Telegram机器人支付概览
Telegram官方为机器人提供了支付API（Payments API），允许机器人向用户发送带有价格信息的发票（Invoice），用户直接在聊天界面内完成支付，无需跳转外部链接。整个支付过程由Telegram托管，但实际扣款由接入的支付提供商完成，比如Stripe、PayPal或Yandex.Money等。这种模式对用户而言安全便捷，对开发者而言减少了自建支付流程的复杂度。
支付API的核心流程是：机器人创建一个发票（价格、商品描述、货币等），通过sendInvoice方法发送给用户；用户点击支付按钮后，Telegram弹出支付界面；支付完成后，Telegram通过update消息通知机器人支付结果（pre_checkout_query和successful_payment）。开发者只需处理好这两个回调，就能实现付费内容的自动发放。
二、准备工作：创建机器人并开通支付权限
要使用支付API，首先需要一个Telegram机器人。如果你还没有，通过BotFather创建：向@BotFather发送/newbot，按提示设置名称和用户名，获取API Token。
接下来，需要在BotFather中开通支付权限。发送命令 /mybots，选择你的机器人，依次点击“Bot Settings” -> “Payments”，然后选择要接入的支付提供商。Telegram要求你提供支付提供商的Token，该Token在你注册支付提供商服务后获得。
注意：BotFather中的支付设置只能选择已支持的提供商，且每个提供商有不同的申请要求。例如Stripe需要你有一个Stripe账户，并且开通了Telegram支付功能。整个配置过程直接通过聊天界面完成，非常快捷。
三、配置支付提供商（以Stripe为例）
Stripe是全球最流行的支付网关之一，也是Telegram支付API的首选集成方式。下面以Stripe为例说明配置步骤。
- 注册并登录Stripe账户，进入Dashboard。
- 在Stripe后台找到“Telegram”相关选项（部分账户需通过应用市场安装Telegram插件）。或者，在Stripe的开发者模式下，复制你的密钥（Secret Key）中的一项：Stripe提供的Telegram Bot API Token通常以“XTR”开头。在Stripe中，这个Token位于“Business Settings” -> “Telegram”中。
- 获取该Token后，回到Telegram的@BotFather，执行/mybots -> 选择机器人 -> Bot Settings -> Payments -> Stripe，粘贴Token。如果Token有效，Telegram会提示支付提供商已绑定。
注意：不同支付提供商的获取方式不同，但原理一致：在提供商侧获取Telegram专用Token，然后通过BotFather绑定。
四、实现支付流程：从发送发票到确认支付
完成配置后，就可以通过代码调用支付API了。核心方法是sendInvoice，下面以Python（python-telegram-bot库）为例展示基本调用顺序。
1. 发送发票
from telegram import InlineKeyboardButton, InlineKeyboardMarkup, LabeledPrice
from telegram.ext import Updater, CommandHandler
def send_invoice(update, context):
chat_id = update.effective_chat.id
title = "高级会员月卡"
description = "解锁所有高级功能"
payload = "custom_payload_123" # 你的自定义数据，用于关联订单
currency = "CNY"
prices = [LabeledPrice("高级会员月卡", 2500)] # 2500表示25.00元
provider_token = "YOUR_PROVIDER_TOKEN"
context.bot.send_invoice(
chat_id, title, description, payload, provider_token, currency, prices
)prices数组中每项包含标签和金额（以“分”为单位，对于人民币是分）。payload参数用于在回调中识别订单，建议唯一。
2. 处理预购确认（pre_checkout_query）
用户点击支付后，Telegram会发送pre_checkout_query更新给机器人。你需要在收到后调用answerPreCheckoutQuery，以确认订单合法或拒绝。通常在这里检查库存或自定义校验。
def pre_checkout_handler(update, context):
query = update.pre_checkout_query
# 校验订单状态，例如检查库存
if not is_available(query.invoice_payload):
query.answer(ok=False, error_message="商品已售罄")
else:
query.answer(ok=True)3. 支付成功回调
支付成功后，Telegram会发送successful_payment消息，包含支付金额、货币、支付方式等信息。你可以在此时为用户开通对应服务，或发送数字内容。
def successful_payment_handler(update, context):
payment = update.message.successful_payment
user_id = update.effective_user.id
payload = payment.invoice_payload
# 根据payload给用户发放权限或商品
grant_access(user_id, payload)最后，在main函数中注册这些处理器，并传递provider_token。开发时注意使用测试模式：Stripe提供测试Token，需要在BotFather中绑定和正式不同的测试Token，测试支付不会真实扣款。
五、处理支付回调与发货
支付成功后的流程因业务而异，但通用步骤为：
- 通过successful_payment的chat_id或user_id确定购买者。
- 根据invoice_payload中的自定义信息查询订单（例如你在发送发票时存储了订单号）。
- 执行“发货”：若是数字内容（如VIP权限、电子书），直接调用API更新用户状态；若是实物商品，则记录收货地址（可要求用户提前发送地址）。
- 若需发送收据或感谢信息，直接回复用户。
注意：Telegram要求机器人必须在支付成功后24小时内完成服务交付，否则可能被停用支付权限。对于自动化的数字商品，通常即时交付；对于实体商品，需要确保物流信息可追踪。
六、安全注意事项与风控建议
接入支付后，安全是重中之重。以下建议务实践行：
- 保护Provider Token：不要将其硬编码在客户端代码或公共仓库中，使用环境变量或专门的配置服务管理。
- 验证update来源：确保所有update都来自Telegram官方服务器，官方库已自动验证，但若你手写HTTPS时应校验secret_token。
- 幂等发货：由于网络原因，Telegram可能重复发送successful_payment，你的发货逻辑必须幂等，即重复处理同一订单不会重复发放或报错。
- 订单金额校验：在pre_checkout_query中校验价格是否与你预期一致，严防恶意修改金额。
- 日志与审计：记录所有支付相关事件，便于排查纠纷和财务对账。
- 风控模型：对高价值商品可设置支付频率限制，例如每用户每日交易次数，或对异常IP做二次验证。
七、常见问题与故障排查
Q：预检检查没有收到回调？
A：检查是否在BotFather中正确配置了支付提供商，且provider_token无误。另外，测试模式下必须使用测试Token，正式Token在测试状态下可能不会触发送发票。
Q：支付成功后一直没有发货？
A：确认successful_payment_handler已正确注册，并且没有异常被抛出。检查日志，看是否收到该更新。如果使用的是异步框架，请确保回调函数执行完成。
Q：能否使用微信/支付宝支付？
A：Telegram官方支付API目前支持的提供商中，没有直接支持微信或支付宝。但你可以通过接入第三方服务（如Stripe的支付宝网关）或使用自定义支付链接绕过官方API，但这样用户体验可能不如原生发票。国内开发者需要特别注意合规要求。
Q：支付金额显示单位错误？
A：sendInvoice中prices的金额单位是“分”或“戈比”等最小货币单位。人民币为分，因此100元应输入10000。
Q：如何测试支付？
A：在BotFather中为机器人绑定Stripe的测试Token，然后在Stripe测试卡片“4242 4242 4242 4242”即可模拟支付。测试完成后切换回正式Token。
总结
通过Telegram官方支付API，我们能够以相对简洁的方式为机器人接入完整的支付收单能力。核心流程归纳为三步：在BotFather中绑定支付提供商、用sendInvoice发送发票、处理pre_checkout_query和successful_payment完成发货。实践时一定要关注安全风控和异常处理，确保业务稳定。希望本指南能帮助你在Telegram机器人上顺利开启商业新篇章。如果你有更多接入经验，欢迎在评论区分享！