TG機器人訂閱支付接入:創建訂單、確認回調與會員權限同步
把訂閱入口放進 TG 機器人,可以讓用戶在熟悉的對話里選擇套餐、查看訂單和收到開通通知。要讓這條流程可靠,機器人負責交互,商戶服務端負責訂單與支付事實;本文不編造未確認的網關字段或機器人 API。
文章目錄
先確定機器人與商戶后臺的分工
TG機器人適合展示訂閱方案、收集用戶選擇和發送開通提醒;商戶服務端負責創建訂單、接收支付狀態和授予權益。即使機器人也能調用后端接口,也不要把機器人消息當作訂單數據庫。這樣在機器人暫時離線時,已付款的訂閱仍有獨立訂單記錄可查。
平臺規則也要先核對:如果在 Telegram Bot 或 Mini App 內銷售數字商品或服務,Telegram 官方要求使用 Telegram Stars。本文的外部支付通道架構不用于規避這項要求;接入前請確認付款發生的位置、服務交付方式與適用規則。稳付pay 的微信、支付寶及 USDT 通道僅可用于經平臺規則、渠道要求和適用法規確認允許的業務。
訂單創建時綁定機器人的用戶身份
用戶選定套餐后,服務端創建唯一訂單號,并把經驗證的 TG 用戶標識、創作者或頻道、套餐版本和訂單號關聯起來。不要僅依賴可修改的昵稱,也不要讓付款后用戶自行提交賬號來領取會員。用戶改名或同時訂閱多個頻道時,訂單仍應能指向正確的賬號和權益。
由商戶服務端創建支付訂單
機器人把套餐選擇交給自己的服務端,由服務端按已確認的接入文檔創建支付訂單,再將付款入口發送給用戶。瀏覽器回跳參數和機器人發來的文本都可能被復制或重放,因此不能把其中的“已付款”字樣直接用于開通。具體網關、字段、簽名和應答以技術人員提供的正式規范為準。
機器人只展示支付入口,不保存支付憑證
付款入口應指向商戶確認過的安全結賬頁面。不要把商戶密鑰、回調密鑰或機器人令牌拼進查詢參數,也不要在群聊里發訂單管理鏈接。創建訂單后向用戶展示金額、期限、訂單參考號和幫助入口;支付過期或狀態未知時,提示先查單再重新下單。
回調先更新訂單,再通知機器人
支付結果按異步通知處理:服務端驗證來源、簽名和訂單字段,檢查金額及狀態,再以數據庫中的唯一訂單記錄完成一次狀態轉換。只有服務端確認成功后,才向機器人發送內部的“可開通”事件。回調接口的字段、驗簽、應答和重試方式必須按當前正式接入文檔執行,本文不補造協議。
確認成功后再加入頻道或延長會員
機器人或商戶后臺收到“可開通”事件后,按已綁定的 TG 用戶標識和商品快照執行加入頻道、開通內容權限或延長到期時間。若機器人無權執行、用戶未啟動機器人或頻道設置限制加入,應保留訂單已支付、權益待處理的狀態并告知人工處理,不得把通知失敗改寫為支付失敗。
安排機器人不可用時的查詢與補處理
提供由訂單號或已驗證用戶身份查詢訂閱狀態的商戶側流程,并記錄機器人通知是否送達。恢復后按支付成功但未開通的訂單生成待處理清單,逐筆確認后再補發權限,避免重放歷史消息造成重復入群或重復延長。令牌輪換、備份和故障告警由商戶按自身部署方式管理。
常見問題
TG機器人可以負責交互與通知,訂單真實性和權益變更仍應由商戶服務端管理。
稳付pay支持 TG 機器人接入嗎?
支持機器人接入咨詢。先說明機器人、網站或應用的訂單分工,接口字段和驗簽方式由雙方技術人員按實際方案確認。
付款完成跳回機器人就算成功嗎?
不算。以商戶服務端驗證并記錄的支付結果為準;機器人收到通知后再讀取訂單狀態并展示結果。
機器人令牌可以放在支付鏈接里嗎?
不可以。令牌是服務端憑證,應放在受控的服務器密鑰配置中,避免進入瀏覽器、URL、截圖和普通日志。
參考資料
本文介紹 TG 機器人的通用訂單與通知架構。實際 Telegram 能力、商戶接口字段、回調驗簽與應答方式由技術人員根據正式文檔確認;不要將機器人提示當作支付憑證,也不要公開機器人令牌。