Web サイトまたは支払い API に x402 を実装する方法。
x402 決済ミドルウェアを Web サイトまたは API に追加するためのステップバイステップのガイド。 402 応答形式、支払い検証、llms.txt との統合について説明します。
Updated April 12, 2026
x402 を実装すると、Web サイトまたは API がエージェントによって即座に収益化できるようになります。 AI エージェントがコンテンツまたは計算をリクエストすると、そのサーバーは構造化された支払い条件を含む HTTP 402 を返します。エージェントはUSDCで支払います。アクセスが許可されます。すべてステートレスな HTTP ラウンドトリップで行われます。
5 つのステップで実装#
ステップ 1: 支払いを検証するミドルウェアを追加する#
保護されたエンドポイントの前にミドルウェアを挿入します。受信リクエストの X-PAYMENT ヘッダーをチェックします。ヘッダーが存在し、有効な場合、リクエストは続行されます。それが欠落しているか不十分な場合、ミドルウェアは 402 応答を返します。
このミドルウェアは、Web サーバーとビジネス ロジックの間に位置します。エンドポイントの内部動作は変わりません。
ステップ 2: 402 応答を構造化する#
支払いが不足している場合、価格 (必要な金額)、通貨 (USDC)、チェーン (支払うブロックチェーン、Base がデフォルト)、受取人 (ウォレットのアドレス)、説明 (支払いでアクセスが許可されるもの)、および有効期限 (支払い条件が有効な期間) を含む JSON 本文を含む 402 ステータス コードが返されます。
構造化された対応により、エージェントは自動支払いを行うことができます。この JSON 本文のない単純な 402 では、エージェントは何も処理できません。
ステップ 3: 受け取った支払いを検証する#
エージェントが X-PAYMENT ヘッダーを使用して再試行するときに、オンチェーン支払いを検証します。 Coinbase Developer Platform SDK または直接 RPC 呼び出しを使用して、正しいチェーン上の正しいアドレスに対して正しい金額で支払いが行われたことを確認します。
検証はリクエストのライフサイクル内に完了する必要があります。エージェントを別の確認フローまで待たせないでください。
ステップ 4: アクセスを許可し、トランザクションを記録する#
支払いが検証されたら、元のリクエストを通常どおり処理し、レスポンスを返します。トランザクションを記録します: エージェント ID、支払った金額、アクセスしたエンドポイント、返された応答、タイムスタンプ。
これらのログは、フィードバック ループ と収益分析にフィードされます。
ステップ 5 – x402 エンドポイントを検出ファイルに公開する#
有料端末を価格情報とともに llms.txt に追加します。支払い要件を明記して、agent-card.json 機能リストにそれらを含めます。 MCP サーバーをお持ちの場合は、関連するツールの説明にpayment_required フィールドを追加します。
これにより、エージェントはサイトで何ができるかだけでなく、各機能の使用にかかる費用も把握できるようになります。
x402 とカード支払いの組み合わせ#
Nevermined Agent Card Payments (2026 年 4 月 9 日開始) を使用すると、販売者は Stripe や Adyen などの標準的な決済プロセッサを通じて決済を受け取りながら、エージェントは Visa または Mastercard から委任された権限で支払いを行うことができます。このハイブリッド アプローチにより、同じエンドポイントを通じて、暗号化マイクロペイメント (ウォレットを持つエージェントの場合) と従来のカード支払い (委任されたカード権限を持つエージェントの場合) を受け入れることができます。
##比較: 従来の API 収益化と x402
|方法 |セットアップ時間 |エージェントの摩擦 |収益モデル |実行可能な最低支払い額 |
| — |
| — |
| — |
| — |
| サブスクリプション付きの API キー |
| x402 |
よくあるエラー構造化された JSON 本文のない単純な 402 を返します。エージェントは、構造化された支払い条件を受け取っていない場合、自動支払いを行うことができません。必ず完全な JSON 仕様を含めてください。#
x402 エンドポイントを検出ファイルで公開しないでください。エージェントが、電話をかける前に端末に支払いが必要であることを認識していない場合、402 応答は取引の機会ではなくエラーのように感じられます。
マイクロペイメントのユースケースに対して価格設定が高すぎる。 x402 のパワーにより、以前は小さすぎて処理できなかった支払いが可能になります。コストが 5 ドルのデータ クエリは、コストが 0.01 ドルのデータ クエリよりも受信するエージェント コールの数が少なくなり、量が増加します。
x402 概要 は戦略的背景を説明しています。 エージェント対応 Web アプリケーション チェックリスト は、開発者向けの広範な設定をカバーしています。
よくある質問#
x402 の実装にはどのくらい時間がかかりますか? 単一エンドポイントの基本的なミドルウェアには 1 ～ 2 時間かかります。支払いの検証と登録を追加すると、さらに 2 ～ 4 時間がかかります。 llms.txt およびエージェント カードとの完全な統合には 1 日かかります。
x402 ミドルウェアではどのようなプログラミング言語が利用可能ですか? Node.js、Python、Go、Cloudflare Workers にはすべて、事前に構築されたミドルウェアがあります。このプロトコルは、HTTP 応答を返し、RPC 呼び出しを行うことができる任意の言語で実装できるほど単純です。
暗号通貨ウォレットは必要ですか? はい、支払いを受け取るためです。 Base 上のシンプルな USDC ウォレットで十分です。受け取ったUSDCは、ステーブルコイン決済をサポートする取引所または決済プロセッサを通じて法定通貨に変換できます。
エンドポイントごとに異なる価格を設定できますか? はい。各エンドポイントは、異なる価格で独自の 402 応答を返すことができます。単純なデータ クエリの費用は 0.001 ドルですが、複雑な計算の費用は 1 ドルです。
エージェントが x402 をサポートしていない場合はどうなりますか? エージェントは処理できない 402 応答を受信し、続行します。 x402 をエージェントの主要な支払いパスとして維持しながら、x402 以外の顧客に代替アクセス方法 (API キー、サブスクリプション) を提供できます。
—この記事では、教育および情報提供のみを目的として、支払いプロトコルと暗号通貨インフラストラクチャについて説明します。これは財務上のアドバイスを構成するものではありません。全規約については、法的通知 をご覧ください。