# HTTP 402・x402・MPP

> HTTP 402 Payment Required とは何か、x402 と Machine Payments Protocol（MPP）がそれを使ってソフトウェアにリクエスト単位で支払わせる仕組み、そしてどちらのプロトコルも決めてくれないこと。

出典: https://spendctl.dev/ja/docs/how-agents-pay/ （spendctl ドキュメント。全体の索引は https://spendctl.dev/llms.txt）

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

## HTTP 402 をひと段落で

ステータスコード 402 は HTTP/1.1（RFC 2068、1997 年 1 月）のときから HTTP にあり、現行の HTTP 仕様である [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-402-payment-required) も、いまだに "reserved for future use"（将来の利用のために予約）としています。30 年近くのあいだ、標準として一緒に定められたものはありませんでした。402 応答に何を載せるべきかについて公開された答えが、x402（2025 年）と MPP（2026 年）の 2 つです。

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

1. クライアントがリソースを要求します：`GET /report`
2. サーバーが `402 Payment Required` で**支払い条件**（quote）を返します。いくらを、どの資産で、どのネットワークまたは支払い方法で、どの受取先に払うかです。
3. クライアントはその支払い条件に合う支払いに署名し、それを付けて同じリクエストを送り直します。
4. サーバーは支払いを確かめ、応答（`200 OK`）と**レシート**を返します。

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

## x402

x402 は 2025 年 5 月に Coinbase が公開しました。2026 年 4 月からは Linux Foundation 傘下の x402 Foundation がプロトコルを管理しており、仕様と SDK は [github.com/x402-foundation/x402](https://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）

MPP は 2026 年 3 月に Stripe と Tempo が公開しました（[発表](https://stripe.com/blog/machine-payments-protocol)、ドキュメントは [mpp.dev](https://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 の両方を提示できます。

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

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

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

この 4 つがポリシーであり、ポリシーはエージェントが書き換えられない場所に置く必要があります。置き場所の比較は[支出管理の置き場所](https://spendctl.dev/ja/docs/spend-controls-compared/)にあります。

## spendctl の位置

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

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

- **x402 v1 と v2**：EVM ネットワークの `exact` スキームで、署名から決済まで通して動きます。Base Sepolia で実際に支払った記録は[実際の支払い](https://spendctl.dev/ja/docs/real-payments/)にあります。
- **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 のサイドカーが署名した、または人間の承認に回したリクエスト。[プラン](https://spendctl.dev/ja/docs/plans/)が数える単位 |
| 承認（approval） | 保留された支払いに対する人間の判断。表示された受取先・ネットワーク・資産・金額に結び付く |
| レシート（receipt） | 試行ごとの台帳の行。誰が、何に、いくら、なぜ払ったかと、トランザクションハッシュ |
| 冪等性キー（idempotency key） | 同じリクエストの再試行で二重に払わないよう、エージェントが送るヘッダ |

## 次に読む

- モックの資金でこの流れを試す：[サンドボックス](https://spendctl.dev/ja/docs/sandbox/)。ローカルなら[クイックスタート](https://spendctl.dev/ja/docs/quickstart/)
- エージェントに、自分では引き上げられない予算を持たせる：[AI エージェントの予算](https://spendctl.dev/ja/docs/agent-budgets/)
- 最初によく聞かれる質問：[よくある質問](https://spendctl.dev/ja/docs/faq/)
