Telegramボットの購読決済連携:注文作成・通知確認・会員権同期
Telegramボットなら、使い慣れたチャットでプラン選択、注文確認、付与通知を行えます。信頼性のため、操作はボット、注文・決済事実は加盟店サーバーが管理します。未確認のゲートウェイ項目やボットAPIは作りません。
この記事の目次
ボットの操作と加盟店の注文管理を分ける
Telegramボットはプラン表示、選択受付、付与通知に適しています。加盟店サーバーは注文作成、決済状態の受信、特典付与を担います。ボットがバックエンドを呼び出す場合でも、メッセージを注文台帳の代わりにしません。ボット停止中も支払済み購読を追跡できます。
まずプラットフォームの規則を確認してください。Telegram Bot または Mini App 内でデジタル商品やサービスを販売する場合、Telegram 公式ルールにより Telegram Stars の利用が必要です。本記事の外部決済チャネル構成は、この要件を回避する目的ではありません。連携前に、決済が行われる場所、サービスの提供方法、適用される規則を確認してください。稳付pay の WeChat、Alipay、USDT チャネルは、プラットフォーム規則、チャネル要件、適用法令で許可されると確認できた業務にのみ利用できます。
注文作成時にボット利用者を紐付ける
プラン選択後、サーバーで一意の注文番号を作り、確認済みのTelegram利用者識別子、制作者・チャンネル、プラン版と関連付けます。変更可能な表示名だけに頼らず、支払い後に利用者が受取アカウントを自由入力する設計も避けます。名前変更や複数チャンネル利用後も対象を特定できます。
加盟店サーバーで決済注文を作成する
ボットから自社バックエンドへプラン選択を渡し、確認済みの接続資料に従って加盟店サーバーが注文を作成し、決済画面を利用者へ送ります。ブラウザーの戻り値やボットの文面は再利用される可能性があるため、「支払済み」の表示だけで付与しません。ゲートウェイ、項目、署名、応答は正式仕様を確認します。
ボットは決済画面を案内し、秘密情報を保持しない
決済リンクは加盟店が確認した安全な画面へ向けます。加盟店秘密情報、コールバック鍵、ボットトークンをクエリに含めず、グループに注文管理リンクを投稿しません。金額、期間、注文参照番号、問い合わせ先を表示します。期限切れや不明状態では再注文前に照会します。
コールバックで注文を更新してからボットへ通知する
決済結果は非同期通知として扱います。サーバーで送信元、署名、注文項目、金額、状態を確認し、一意の注文記録を一度だけ遷移させます。確認後に内部の付与イベントをボットへ送ります。コールバック項目、署名検証、応答、再試行は現行の正式資料に従い、本ガイドで仕様を作りません。
確認後にチャンネル権限を付与し会員期間を延長する
付与イベントを受けた後、ボットまたは加盟店管理側は紐付いたTelegram識別子とプラン情報でチャンネル参加、閲覧権、期間延長を行います。権限不足、利用者がボットを開始していない、チャンネル設定の制限がある場合は「支払済み・付与待ち」を保ち、個別対応へ移します。通知失敗を決済失敗に書き換えません。
ボット停止時の照会と復旧を用意する
加盟店側に注文番号または確認済み利用者IDで購読を照会する手順を用意し、ボット通知の配信結果を記録します。復旧後は支払済み・未付与の注文を一覧化し、各件を確認してから権限を補います。過去の通知再送で重複参加・期間延長を起こさないようにします。トークン更新、バックアップ、障害通知は自社環境で管理します。
よくある質問
Telegramボットは操作や通知を担えますが、注文確認と特典変更は加盟店サーバーで管理します。
稳付payはTelegramボット連携に対応していますか?
ボット連携の相談を受け付けています。ボット・サイト・アプリの注文処理を説明し、実際の項目や検証方法は技術担当者が確認します。
ボットへ戻れば支払い成功と判断できますか?
いいえ。加盟店サーバーが検証・記録した決済結果を基準にし、ボットは注文状態を取得してから表示します。
ボットトークンを決済リンクに含めてもよいですか?
できません。トークンはサーバー資格情報として保護し、ブラウザー、URL、画像、通常ログに出さないでください。
参考資料
本ガイドはTGボットの一般的な注文・通知構成を扱います。Telegramの機能、加盟店項目、コールバック検証・応答は正式資料に基づき技術担当者が確認します。ボット通知は決済証明ではなく、トークンを公開しません。