gotgbot实战案例：构建功能完备的Telegram支付机器人

【免费下载链接】gotgbotAutogenerated Go wrapper for the telegram API. Inspired by the python-telegram-bot library.项目地址: https://gitcode.com/gh_mirrors/go/gotgbot

在数字化时代，Telegram机器人已成为企业和开发者提供服务的重要渠道。本文将介绍如何使用gotgbot框架快速构建一个支持Telegram Stars支付的功能完备机器人，帮助你轻松实现数字产品的销售与管理。

🚀 为什么选择gotgbot开发支付机器人？

gotgbot是一个自动生成的Telegram API Go语言包装器，灵感来源于python-telegram-bot库。它提供了完整的支付功能支持，包括：

• 支持Telegram Stars（XTR）支付系统
• 完整的发票创建与管理流程
• 支付验证与退款处理
• 与Telegram支付API的无缝集成

项目中提供了一个完整的支付机器人示例，位于samples/paymentsBot/目录，展示了如何实现从发票发送到支付完成的全流程。

📋 开发前准备

环境要求

• Go 1.16+ 开发环境
• Telegram账号和创建的机器人（通过@BotFather）
• 支付提供商令牌（通过@BotFather获取，Telegram Stars支付可传空字符串）

获取项目代码

git clone https://gitcode.com/gh_mirrors/go/gotgbot cd gotgbot

🔧 核心功能实现步骤

1. 初始化机器人

首先，我们需要创建一个基本的机器人框架，设置令牌并初始化调度器：

func main() { token := os.Getenv("TOKEN") if token == "" { panic("TOKEN environment variable is empty") } b, err := gotgbot.NewBot(token, nil) if err != nil { panic("failed to create new bot: " + err.Error()) } dispatcher := ext.NewDispatcher(&ext.DispatcherOpts{ Error: func(b *gotgbot.Bot, ctx *ext.Context, err error) ext.DispatcherAction { log.Println("an error occurred while handling update:", err.Error()) return ext.DispatcherActionNoop }, MaxRoutines: ext.DefaultMaxRoutines, }) updater := ext.NewUpdater(dispatcher, nil) // 添加处理器... err = updater.StartPolling(b, &ext.PollingOpts{ DropPendingUpdates: true, }) if err != nil { panic("failed to start polling: " + err.Error()) } updater.Idle() }

2. 创建支付相关处理器

支付机器人需要处理三种关键事件：命令交互、支付前验证和支付完成：

// 添加命令处理器 dispatcher.AddHandler(handlers.NewCommand("start", start)) // 支付前验证处理器 dispatcher.AddHandler(handlers.NewPreCheckoutQuery(precheckoutquery.All, preCheckout)) // 支付完成处理器 dispatcher.AddHandler(handlers.NewMessage(message.SuccessfulPayment, paymentComplete)) // 退款支持命令 dispatcher.AddHandler(handlers.NewCommand("paysupport", paySupport))

3. 实现发票发送功能

使用SendInvoice方法创建并发送Telegram Stars支付发票：

func start(b *gotgbot.Bot, ctx *ext.Context) error { // 生成唯一的发票标识符 payload := uuid.NewString() // 发送发票（XTR表示Telegram Stars） _, err = b.SendInvoice(ctx.EffectiveChat.Id, "Product Name", "Some detailed description", payload, "XTR", []gotgbot.LabeledPrice{{ Label: "Some product", Amount: 100, // 100 Telegram Stars }}, &gotgbot.SendInvoiceOpts{ ProtectContent: true, // 防止发票被转发 }) if err != nil { return fmt.Errorf("failed to generate invoice: %w", err) } return nil }

4. 支付前验证

在用户确认支付前，我们可以进行必要的验证：

func preCheckout(b *gotgbot.Bot, ctx *ext.Context) error { // 这里可以添加自定义验证逻辑 // 例如：验证用户权限、检查库存等 // 验证通过，允许支付继续 _, err := ctx.PreCheckoutQuery.Answer(b, true, nil) if err != nil { return fmt.Errorf("failed to answer precheckout query: %w", err) } return nil }

5. 处理支付完成事件

支付成功后，我们需要向用户提供产品或服务：

func paymentComplete(b *gotgbot.Bot, ctx *ext.Context) error { // 支付成功，这里可以添加产品交付逻辑 _, err := ctx.EffectiveMessage.Reply(b, "Payment complete - in a real bot, this is where you would provision the product that has been paid for.", nil) if err != nil { return fmt.Errorf("failed to send payment complete message: %w", err) } return nil }

6. 实现退款支持

根据Telegram Stars服务条款，必须提供退款支持：

func paySupport(b *gotgbot.Bot, ctx *ext.Context) error { // 这里可以实现退款流程说明或直接处理退款请求 _, err := ctx.EffectiveMessage.Reply(b, "Explain your refund process here.", nil) if err != nil { return fmt.Errorf("failed to describe refund process: %w", err) } return nil }

📝 关键API参数说明

发票创建参数

• currency: 支付货币代码，使用"XTR"表示Telegram Stars
• prices: 价格明细，Telegram Stars支付必须包含 exactly 一个项目
• payload: 机器人定义的发票标识符，用于内部处理
• provider_token: 支付提供商令牌，Telegram Stars支付可传空字符串

支付相关结构体

在gen_types.go中定义了支付相关的核心结构体：

• Invoice: 包含发票基本信息
• SuccessfulPayment: 支付成功信息
• RefundedPayment: 退款信息

⚙️ 部署与测试

设置环境变量

export TOKEN="your-bot-token-here"

运行支付机器人示例

cd samples/paymentsBot go run main.go

测试流程

1. 在Telegram中搜索你的机器人并发送/start命令
2. 机器人将发送一个Telegram Stars支付发票
3. 点击"Pay"按钮完成支付
4. 支付成功后，机器人将发送确认消息

📚 扩展学习资源

• 完整支付机器人示例代码：samples/paymentsBot/main.go
• Telegram支付API文档：gen_types.go中包含详细注释
• gotgbot框架文档：项目根目录下的README.md

通过本文介绍的方法，你可以快速构建一个功能完备的Telegram支付机器人，支持Telegram Stars支付，为你的数字产品提供便捷的销售渠道。gotgbot框架的强大功能和简洁API让支付集成变得简单高效，无论是小型项目还是大型商业应用都能轻松应对。

【免费下载链接】gotgbotAutogenerated Go wrapper for the telegram API. Inspired by the python-telegram-bot library.项目地址: https://gitcode.com/gh_mirrors/go/gotgbot