Merchant API（開発者向け）
加盟店向けのAPI。アプリ、請求書、送金、Webhook。
Merchant APIとは
Merchant APIは、事業者とボットのための決済APIです。 アプリを作成してAPIトークンを受け取ると、自分のコードからTelegramユーザーへの請求、送金、残高の確認ができます。
開発者向けのはじめかた
ミニアプリで加盟店アプリを作成し、APIトークンを一度だけコピーすれば、APIを呼び出せます。 設定はすべてその他 → Merchant APIにあります。
AIエージェントを連携する
リモートMCPサーバーに対応するコーディングエージェントを、https://app.tgpaycrypto.com/mcpに接続できます。エージェントはAPIドキュメントを読み、加盟店アプリの作成を申請し、Webhookの設定や連携コードの作成を手伝います。ボットでアプリの作成を承認すると、トークンを手でコピーせずに、エージェントに制限付きトークンを渡せます。実際の決済を受け付ける前に、完成した実装を確認してテストしてください。
請求書で支払いを受け取る
請求書は、Telegramユーザーに料金を請求するしくみです。APIで作成したリンクを支払者に送ります。支払いが成功すると、加盟店手数料を引いた金額がアプリの残高に反映されます。
Merchant APIの手数料と限度額
請求書には、受け取る金額から引かれるサービス手数料がかかります。 送金と送金リンクには、金額の制限があります。 以下の数値は現在の設定であって、契約の条件ではありません。 表示と食い違う場合はアプリが正しく、いちばん確かなのは自分の支払い済みの請求書です。
Merchant APIリファレンス
すべてのメソッドに共通する決まりと、読み取り専用のカタログ系メソッドをまとめます。 メソッドごとのページは請求書と返金、送金と送金リンク、サブスクリプション、Webhookです。
APIリファレンス：請求書と返金
請求書のメソッドはcreateInvoice・getInvoices・deleteInvoice・refundInvoiceです。 共通の決まり（認証、レスポンスの形、金額、spend_id）はMerchant APIリファレンスにまとめています。 手順に沿った解説は請求書で支払いを受け取るです。
APIリファレンス：送金と送金リンク
アプリの残高から資金を送り出すためのメソッドです。 送金は、アプリの残高からTelegramユーザーのウォレットへ資金を送ります。新しい受取人の場合は、ボットを開くまで資金を保留します。 送金リンクは、先に資金を確保しておく、受け取り可能なリンクです。 共通の決まり（認証、レスポンスの形、金額、spend_id）はMerchant APIリファレンスにまとめています。
APIリファレンス：サブスクリプション
継続課金です。Crypto Botに対する拡張にあたります。 プラン（金額と期間）を作り、その承認リンクをユーザーに送ると、期間ごとにユーザーのウォレット残高から自動で課金され、手数料を引いた額がアプリの残高に入ります。 共通の決まりはMerchant APIリファレンスにまとめています。
APIリファレンス：Webhook
Webhookは、イベントが起きたあとに自分のサーバーへ知らせを送ります。 アプリのWebhook URL（任意）をその他 → Merchant APIで設定すると、受け取る設定にしたイベントごとに、署名付きのJSONボディがPOSTされます。
Merchant API利用規約
本規約は、Merchant APIの利用に適用されます。アプリ、APIトークン、請求書、サブスクリプション、送金、送金リンク、Webhook、AIエージェント連携が対象です。 ウォレット本体の利用規約およびAMLポリシーに加えて適用されます。 アプリを作成した時点で、本規約に同意したものとみなします。2026年9月7日より前に作成したアプリを引き続き利用する場合も同様です。