Telegram付费进群机器人源码下载 付费入群验证 OkPay支付 自动发邀请链接/邀请返利

这是一套面向 Telegram 付费社群 的进群验证机器人源码，主要用于处理用户下单、在线支付和自动进群之间的流程。

用户通过 Telegram 私聊机器人发起购买，创建订单后跳转到 OkPay 完成支付。支付成功后，机器人通过 Telegram Bot API 生成一次性邀请链接并发送给用户。对于运营付费群、知识付费群或会员社群的人来说，可以将整个购买和进群过程放在 Telegram 内完成。

除了基础的付费进群，还提供邀请返利、阶梯价格、管理员审核结算和订单查单等功能。支付部分采用可插拔设计，当前默认接入 OkPay，并使用 HMAC-SHA256 进行签名验证。

付费进群的基本流程

整个流程比较直接：

用户私聊机器人 → 创建订单 → OkPay 支付 → 支付成功 → 生成一次性邀请链接 → 用户进群。

订单支持超时失效和取消操作。支付完成后，机器人负责调用 Telegram Bot API 创建单次有效的邀请链接，用户不需要再由管理员手动发送入群链接。

一次性进群链接

系统在支付成功后生成一次性邀请链接，而不是长期公开一个固定群链接。

这样可以将付款记录和进群操作对应起来。对付费群来说，每笔订单都可以单独处理，减少固定邀请链接被转发后产生的管理问题。

需要注意，机器人必须是目标群管理员，并具备邀请用户或管理邀请链接相关权限，否则无法正常创建邀请链接。

阶梯定价

系统支持按照已经完成付费的人数进行分档定价。

例如可以设置不同人数阶段对应不同价格，随着已付费人数增加，后续用户按照新的档位购买。阶梯规则既可以通过 .env 配置，也可以在后台进行调整。

这种模式比较适合有早鸟价、分阶段涨价或限量优惠需求的付费社群。

邀请返利与推广关系

机器人支持通过 Telegram 深链建立推广关系。推广链接采用类似下面的形式：

?start=p_xxx

被邀请用户通过对应链接进入机器人并完成付费后，系统可以按照配置比例计算推荐人的返利。

这样可以在付费群之外增加基础的用户推广机制，推荐人不需要手动向后台提交订单信息，系统可以根据邀请关系自动识别。

返利审核与自动结算

推广产生的返利不会直接无条件出款，系统提供管理员审核和结算流程。

管理员确认后，系统可以通过 OkPay 向推荐人发起自动出款。对于需要人工检查推广订单的运营模式，这种方式可以在自动计算和人工审核之间保留一个确认环节。

邀请排行榜

系统提供付费邀请榜 Top20，可以按照付费邀请数据展示推广排名。

对于有推广活动的社群，可以将排行榜作为活动页面或运营数据的一部分使用。

支付渠道采用可插拔方式

当前默认支付渠道为 OkPay，并使用 HMAC-SHA256 进行请求签名和验证。

支付模块采用可插拔的设计思路，如果后续需要接入其他支付方式，可以根据现有接口结构继续开发对应的支付适配层。

支付回调之外，还有查单兜底

实际运行支付系统时，除了正常回调，还可能遇到网络异常、回调延迟或者服务短暂不可用的情况。

这个项目增加了订单到期前的主动查单机制。系统会再次向支付渠道确认订单状态，尽量降低支付成功但回调没有正常到达时出现的漏单问题。

如果用户已经付款但没有收到邀请链接，排查时可以重点查看公网回调是否返回 200、日志中是否出现 OkPay 回调记录，以及 Bot 当前是否拥有目标群的邀请权限。

演示模式

管理员可以使用：

/paytest

进入演示支付流程。

这个模式不需要真实支付，也可以把创建订单、支付成功后的处理以及后续流程走一遍，比较适合首次部署时测试机器人配置。

人工客服

系统支持配置客服跳转链接。当用户在支付、订单或进群过程中遇到问题时，可以从机器人提供的客服入口联系人工处理。

支付成功但没有收到进群链接怎么办？

可以依次检查公网支付回调地址是否能够正常访问，并查看日志中是否有“收到 okpay 回调”的记录。

随后检查 Telegram Bot 是否仍然是目标群管理员，以及是否拥有创建邀请链接所需的权限，同时确认 TARGET_GROUP_ID 配置正确。

项目还提供订单到期前查单机制，部分由于支付回调异常造成的情况可以通过主动查单再次确认并尝试补发邀请链接。

常见部署问题

下单时 callback_url 校验失败

如果后台已经配置了全局回调地址，应保持：

OKPAY_SEND_CALLBACK_URL=false

避免重复传递 callback_url 导致支付接口校验失败。

签名或身份认证失败

重点检查 OKPAY_APP_ID、OKPAY_TOKEN 以及服务器时间。如果服务器时间存在较大偏差，也可能影响签名验证，因此建议确认 NTP 时间同步正常。

无法生成 Telegram 邀请链接

确认 Bot 已加入目标群并拥有管理员权限，同时检查是否具有邀请用户或管理邀请链接的权限。

健康检查无法访问

可以先在服务器本机测试：

curl 127.0.0.1:8090/health

如果本机正常，再检查 Nginx 反向代理、域名解析和 SSL 配置。

项目的 webhook 和 Bot 使用同一个进程，启动时需要使用：

python -m bot.main

适合哪些场景？

这套源码主要适合把 Telegram 作为用户入口和社群载体的付费业务，例如：

• Telegram 付费会员群
• 知识付费社群
• 付费资讯群
• 订阅型 Telegram 社群
• 邀请返利型会员群

如果项目需要的只是一个简单的 Telegram 自动回复机器人，那么这套系统的功能会相对多一些；它更适合已经确定采用“支付 → 验证 → 自动进群”这一流程的付费社群项目。

源码核心功能

• Telegram 私聊下单
• OkPay 支付
• 支付状态回调
• 一次性进群邀请链接
• 订单超时和取消
• 阶梯价格
• 邀请深链推广
• 推广返利
• 管理员审核结算
• OkPay 自动出款
• 付费邀请排行榜 Top20
• 人工客服入口
• 订单主动查单
• 无真实支付演示模式

从功能结构来看，它主要解决的是 Telegram 付费社群中几个比较具体的问题：订单如何创建、付款如何确认、用户如何自动获得进群权限，以及推广返利和异常订单如何处理。对于需要研究或二次开发 Telegram 付费进群机器人的开发者，可以围绕现有支付、Bot API 和推广机制继续扩展。