x402 の課金実装で決めることは、「402 を返す」だけではありません。①価格をどこに宣言するか、②未払いのときに何を返すか、③課金しない境界をどこに置くかの3点です。当方の公開URLを 2026-10-19 に実測すると、無料3面は合計 854,637 B で支払い0、有料3経路の402は本文合計 77,978 B・ヘッダ合計 18,016 B でした。
価格は 0.001〜0.05 USDC の範囲で、/gas が 0.001、/price が 0.02、/check が 0.05。同じ価格を本文（V1・atomic 整数）とヘッダ（V2）の両方に置くのが実装の要点で、本文だけ・ヘッダだけでは買い手のクライアントによっては読めません。
" }, { "見出し": "実測: 無料3面と402 3経路", "html": "| 面 | 条件 | 応答 | 本文 | 価格 | 読み取れること |
|---|---|---|---|---|---|
/openapi.json | 無料 | 200 | 159,606 B | 0 | 54 paths |
/product.json | 無料 | 200 | 627,189 B | 0 | 45有料経路・9価格帯 |
/ja | 無料（HTML） | 200 | 67,842 B | 0 | 日本語の入口 |
/gas?chains=base,eth | 未払い | 402 | 21,774 B | 0.001 USDC | ヘッダ 5,464 B |
/price | 未払い | 402 | 28,113 B | 0.02 USDC | ヘッダ 6,888 B |
/check | 未払い | 402 | 28,091 B | 0.05 USDC | ヘッダ 5,664 B |
/check?url=not-a-url | 形式エラー | 400 | 271 B | 0 | 課金前に拒否 |
応答時間は curl で /price 0.524 秒、/gas 0.443 秒、/check 0.536 秒（各1回・同時刻ではない）。
" }, { "見出し": "402 に書くもの: 本文11キー・accepts 10項目", "html": "未払いGETの402本文は、3経路とも同じ11のトップレベルキーを持っていました: price x402Version error accepts resource extensions payment_required_v2 receive what_you_get try_before_you_pay terms。accepts[0] は10項目で、価格は maxAmountRequired に atomic 整数で入ります。
maxAmountRequired=1000（/gas）maxAmountRequired=20000（/price）maxAmountRequired=50000（/check）レスポンスヘッダの payment-required はx402Version=2 で、accepts[0].amount が本文と同じ 20000 でした。本文のキー名は maxAmountRequired、ヘッダは amount と違うので、実装では同じ値を両方に出す関数を1つにまとめるのが安全です。
402本文は 21,774〜28,113 B と大きめです。これはwhat_you_get try_before_you_pay terms まで含むためで、買い手は払わずに納品内容と無料の試し方を読めます。実装では「402＝エラー」ではなく商品説明つきの見積もりとして設計します。
課金実装で見落としやすいのが不正な入力を402より前に返すことです。/check?url=not-a-url は 400・271 B で返り、402本文 28,091 B の約104分の1でした。上流呼び出しも課金も起きないので、形式エラーは無料にするのが自然です。
一方で /price?pair=nope は 402 でした。つまり入力の検証は経路ごとに違います。「この経路は無料で止まる」と決め打ちせず、実装した経路ごとに 400 を返す条件を1つずつ決めるのが安全です。当方の実測では、/check はURL形式を課金前に見ますが、/price はパラメータの妥当性を課金前に見ていません。
無料の /product.json は 627,189 B・45有料経路を持ち、価格は 9種類でした: 0.001 / 0.002 / 0.003 / 0.005 / 0.01 / 0.02 / 0.05 / 0.25 / 3 USDC。3経路の402と突き合わせると、/gas 0.001・/price 0.02・/check 0.05 は一致しています。
実装では、価格の正本を1か所（定数）に置き、402本文・ヘッダ・product.json を同じ値から生成するのがよいです。当方の /openapi.json は 54 paths で、402 の形もここから読めます。価格を変えたときに3か所のどれかが古いのが典型的な事故なので、デプロイ時に3か所を突き合わせるテストを1本置きます。
支払い後の200本文は取得していません（支払い・SMS・KYCを伴う操作はしない制約）。したがって納品の中身・鮮度・返金・失敗時の再試行は未確認です。数字はすべて「402が返るところ、無料の200が返るところ」までの実測で、product.json の45経路と価格は宣言値であり、45本の402と1本ずつ突き合わせたわけではありません。
実装の最小構成は /ja/x402-implementation-example、買い手側の順序は /ja/x402-usage、価格の相場は /ja/price-benchmark に実測でまとめています。仕様の全体は無料の /openapi.json（54 paths）で読めます。