HTTP 402・x402・MPP
要点:402 Payment Required は、リクエストに支払いが必要なときにサーバーが返す HTTP ステータスです。そこに何を載せるかを定めているのが x402 と MPP の 2 つのプロトコルで、サーバーが 402 で価格を示し、クライアントが支払いに署名して同じリクエストを送り直し、サーバーが 200 とレシートを返します。どちらもエージェントに支払いの方法を教えますが、支払うべきかどうかは決めません。そこを受け持つのが spendctl です。
HTTP 402 をひと段落で
Section titled “HTTP 402 をひと段落で”ステータスコード 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 つのプロトコルに共通する流れ”- クライアントがリソースを要求します:
GET /report - サーバーが
402 Payment Requiredで支払い条件(quote)を返します。いくらを、どの資産で、どのネットワークまたは支払い方法で、どの受取先に払うかです。 - クライアントはその支払い条件に合う支払いに署名し、それを付けて同じリクエストを送り直します。
- サーバーは支払いを確かめ、応答(
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(Machine Payments Protocol)
Section titled “MPP(Machine Payments Protocol)”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 の位置
Section titled “spendctl の位置”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) | 同じリクエストの再試行で二重に払わないよう、エージェントが送るヘッダ |
- モックの資金でこの流れを試す:サンドボックス。ローカルならクイックスタート
- エージェントに、自分では引き上げられない予算を持たせる:AI エージェントの予算
- 最初によく聞かれる質問:よくある質問