コンテンツにスキップ

HTTP 402・x402・MPP

要点:402 Payment Required は、リクエストに支払いが必要なときにサーバーが返す HTTP ステータスです。そこに何を載せるかを定めているのが x402 と MPP の 2 つのプロトコルで、サーバーが 402 で価格を示し、クライアントが支払いに署名して同じリクエストを送り直し、サーバーが 200 とレシートを返します。どちらもエージェントに支払いの方法を教えますが、支払うべきかどうかは決めません。そこを受け持つのが spendctl です。

ステータスコード 402 は HTTP/1.1(RFC 2068、1997 年 1 月)のときから HTTP にあり、現行の HTTP 仕様である RFC 9110 も、いまだに “reserved for future use”(将来の利用のために予約)としています。30 年近くのあいだ、標準として一緒に定められたものはありませんでした。402 応答に何を載せるべきかについて公開された答えが、x402(2025 年)と MPP(2026 年)の 2 つです。

2 つのプロトコルに共通する流れ

Section titled “2 つのプロトコルに共通する流れ”
  1. クライアントがリソースを要求します:GET /report
  2. サーバーが 402 Payment Required で支払い条件(quote)を返します。いくらを、どの資産で、どのネットワークまたは支払い方法で、どの受取先に払うかです。
  3. クライアントはその支払い条件に合う支払いに署名し、それを付けて同じリクエストを送り直します。
  4. サーバーは支払いを確かめ、応答(200 OK)とレシートを返します。

アカウントも API キーも請求書も要りません。エージェントにとっての魅力はそこにあり、ソフトウェアが初めて出会う API にも支払えます。同時に、それがリスクでもあります。支払い条件を出すのはサーバーで、署名するのはクライアントだからです。

x402 は 2025 年 5 月に Coinbase が公開しました。2026 年 4 月からは Linux Foundation 傘下の x402 Foundation がプロトコルを管理しており、仕様と SDK は github.com/x402-foundation/x402 にあります。使われているバージョンは 2 つあり、クライアントは両方を読める必要があります。

x402 v1 x402 v2
支払い条件(サーバー → クライアント) 402 の JSON 本文 PAYMENT-REQUIRED ヘッダ(base64 の JSON)
支払い(クライアント → サーバー) X-PAYMENT ヘッダ PAYMENT-SIGNATURE ヘッダ
決済結果(サーバー → クライアント) X-PAYMENT-RESPONSE ヘッダ PAYMENT-RESPONSE ヘッダ
ネットワーク名 base-sepolia eip155:84532 のような CAIP-2 の ID
金額のフィールド maxAmountRequired amount(資産の最小単位)

支払い条件は accepts の下に 1 つ以上の選択肢を並べます。各選択肢が示すのは、スキーム(exact が一般的です)、ネットワーク、資産(トークンコントラクト)、金額、受取先(payTo)、認可の有効期間です。EVM ネットワークの exact では、クライアントは EIP-3009 の transferWithAuthorization に署名します。売り手が選んだファシリテータが署名を検証してオンチェーンで決済するので、どちらの側もノードを動かす必要がありません。

MPP は 2026 年 3 月に Stripe と Tempo が公開しました(発表、ドキュメントは mpp.dev)。x402 の上に載る層ではなく別のプロトコルで、HTTP の認証ヘッダを使います。

MPP
支払い条件(サーバー → クライアント) WWW-Authenticate: Payment …(method、intent、request を持つ)
支払い(クライアント → サーバー) Authorization: Payment …
レシート(サーバー → クライアント) Payment-Receipt ヘッダ

charge のチャレンジ(支払い条件)に入っている request が、金額、通貨(たとえば usd、またはトークン)、受取先を運びます。method は、どの決済手段を使うかを示します。Stripe の Shared Payment Tokens によるカード払いもそのひとつなので、MPP はステーブルコインに限られません。サーバーは同じ 402 で x402 と MPP の両方を提示できます。

どちらのプロトコルも決めないこと

Section titled “どちらのプロトコルも決めないこと”

どちらのプロトコルも、やり取りの手順を定めています。買い手側の判断は定めていません。

  • x402 v2 の仕様は “Client-side budget management”(クライアント側の予算管理)を対象外としています。
  • 公式の x402 クライアントは 1 回あたりの支払いに上限をかけるだけで、それ以外はサーバーが示した金額をそのまま払います。10 倍に吊り上げられた価格を払った例が、公開の報告にあります(x402 issue #3866)。
  • 1 日あたりの合計、エージェントが支払ってよい売り手の一覧、しきい値を超えたときの人間の承認、すべての試行をまとめた 1 つの記録は、どれもエージェントを動かす側に任されています。

この 4 つがポリシーであり、ポリシーはエージェントが書き換えられない場所に置く必要があります。置き場所の比較は支出管理の置き場所にあります。

spendctl は、エージェントの隣でお客様が動かすサイドカーです(npx spendctl init && npx spendctl start)。エージェントはリクエストをサイドカー経由で送ります。売り手が 402 を返すと、spendctl は x402 v1、x402 v2、MPP のどの支払い条件も同じ形(受取先、ネットワーク、資産、USD 建ての金額)に読み替え、ポリシーと照らし、ポリシーが求めれば人間の判断を待って保留し、お客様のウォレットに 1 回だけ署名を依頼し、その試行を台帳の 1 行として記録します。

現時点で動くものを正確に書くと、次のとおりです。

  • x402 v1 と v2:EVM ネットワークの exact スキームで、署名から決済まで通して動きます。Base Sepolia で実際に支払った記録は実際の支払いにあります。
  • MPP:charge のチャレンジを解析し、同じポリシーと照らして記録します。支払うには、mppx の credential provider をコードでサイドカーに組み込む必要があります。そのための spendctl.yaml の設定はまだなく、spendctl を通した実際の MPP 支払いはまだ行われていません。
用語 意味
支払い条件(402 challenge、quote) 売り手の 402 応答。いくらを、どの資産で、誰に払ってほしいか
accepts x402 の支払い条件に並ぶ支払いの選択肢。クライアントが 1 つを選ぶ
payTo、受取先(recipient) 支払いが届くアドレスまたはアカウント
CAIP-2 チェーンの識別子の形式。eip155:8453 は Base、eip155:84532 は Base Sepolia
atomic units(最小単位) 資産の最小単位で表した金額。小数 6 桁のトークンの 10000 は 0.01
EIP-3009 x402 の exact スキームが EVM ネットワークで使う、署名付きの送金認可
ファシリテータ(facilitator) 売り手が選ぶサービスで、x402 の支払いを検証して決済する
サイドカー(sidecar) エージェントの隣でお客様が動かすプロセス。リクエストはここを通る
支出ポリシー(spend policy) 支払いが通らなければならないルール。予算、許可ホスト、受取先の固定、承認しきい値
governed payment(管理対象支払い) spendctl のサイドカーが署名した、または人間の承認に回したリクエスト。プランが数える単位
承認(approval) 保留された支払いに対する人間の判断。表示された受取先・ネットワーク・資産・金額に結び付く
レシート(receipt) 試行ごとの台帳の行。誰が、何に、いくら、なぜ払ったかと、トランザクションハッシュ
冪等性キー(idempotency key) 同じリクエストの再試行で二重に払わないよう、エージェントが送るヘッダ