FAQ

よく寄せられる質問と回答をまとめています。

基本

x402とは何ですか？（一言で）

x402は、休眠中のHTTPの402 Payment Requiredステータスコードを、API・Webサイト・自律型エージェント向けの完全なオンチェーン決済レイヤーとして機能させるオープンソースプロトコルです。

x402はCDP（Coinbase Developer Platform）の製品ですか？

いいえ。Coinbase Developer Platformはツールの提供と規格の策定に携わっていますが、x402はApache-2.0ライセンスのオープンプロトコルであり、Coinbaseの製品を使わなくても利用できます。x402 Foundationはこの区別をさらに明確にし、x402を中立的な決済規格にしていく予定です。

なぜ従来の決済レールやAPIキーではなくx402なのですか？

従来の決済レールはクレジットカードネットワーク・ユーザーアカウント・複数ステップのUIフローが必要です。x402はこれらの依存をなくし、プログラム的でHTTPネイティブな決済（AIエージェントに最適）を実現しながら、手数料をほぼゼロに抑え、約1秒で決済できます。

言語・フレームワークサポート

どの言語・フレームワークに対応していますか？

TypeScript・Python・Goがリファレンス実装として用意されています。x402はオープンプロトコルであるため、Rust・Javaなど他の言語での実装も可能です。新しい言語サポートの追加に興味がある方は、GitHubでIssueを開いてください。

ファシリテーター

現在、誰がファシリテーターを運営していますか？

複数の組織が本番ファシリテーターを運営しています。プロトコルはパーミッションレスであり、誰でもファシリテーターを運営できます。コミュニティ運営のファシリテーターや、カスタムKYT/KYCフローが必要な企業向けのプライベートファシリテーターなどがあります。詳細はx402エコシステムをご参照ください。

悪意のあるファシリテーターが資金を盗んだり虚偽報告したりするのを防ぐ仕組みは？

すべてのx402のPaymentPayloadはバイヤーが署名し、オンチェーンで直接決済されます。トランザクションを改ざんしようとするファシリテーターは署名チェックに失敗し、決済を完了できません。

価格と仕組み

エンドポイントの価格はどのように設定すべきですか？

一般的なパターンとしては以下があります：

リクエストごとの固定料金（例：1リクエストあたり$0.001）
階層型（/basic と /pro で異なる価格）
上限付き（作業中）：実際の使用量（トークン数・MB等）に応じた「pay-up-to」方式

x402をMetronomeなどの使用量・プランマネージャーと統合できますか？

はい。x402は支払いの実行を担います。Metronomeで使用量を計測・集計したり、プリペイドクレジットを発行したりして、上限を超えた場合のみ課金することも可能です。

対応アセット・ネットワーク・手数料

現在どのアセットとネットワークに対応していますか？

ネットワーク	CAIP-2 ID	アセット	ステータス
Base	eip155:8453	任意のERC-20	Mainnet
Base Sepolia	eip155:84532	任意のERC-20	Testnet
Solana	solana:5eykt4...	SPL / Token-2022	Mainnet
Solana Devnet	solana:EtWTRA...	SPL / Token-2022	Testnet

ガス代はオンチェーンで発生しますが、多くのファシリテーターはファシリテーター手数料ゼロで提供しています。追加チェーン・アセットへの対応はロードマップに含まれています。

x402はフィアットオフランプやクレジットカード入金をサポートしていますか？

ネイティブにはサポートしていません。ただし、ファシリテーターやサードパーティのゲートウェイがオン・オフランプをx402フローに組み合わせることは可能です。

セキュリティ

秘密鍵をバックエンドに公開する必要がありますか？

いいえ。推奨パターンは以下の通りです：

バイヤー（クライアント・エージェント）はランタイム（ブラウザ・サーバーレス・エージェントVM）内でローカルに署名します。CDP Wallet APIを使ってプログラムウォレットを作成できます。
セラーはバイヤーの鍵を保持する必要はなく、署名の検証のみを行います。

返金はどのように機能しますか？

現在のexactスキームはプッシュ型の支払いであり、実行後は取り消せません。2つの選択肢があります：

ビジネスロジックによる返金：セラーがバイヤーに新たなUSDC送金を行う
エスクロースキーム：将来の仕様でHTLCやホールドインボイスなどの条件付き送金が追加される可能性があります

AIエージェントによる利用

エージェントはどのように支払う金額を知りますか？

エージェントは人間と同じフローに従います：

リクエストを送信する
PAYMENT-REQUIREDヘッダーを解析する
x402クライアントSDKで適切な要件を選択してペイロードに署名する
PAYMENT-SIGNATUREヘッダーを付けてリトライする

エージェントにはウォレットが必要ですか？

はい。プログラムウォレット（CDP Wallet API・viem・ethers-v6 HDウォレットなど）を使うことで、エージェントはシードフレーズを公開せずにEIP-712ペイロードに署名できます。Solanaベースの支払いには@solana/kitでトランザクションに署名できます。

ガバナンスとロードマップ

公式仕様やホワイトペーパーはありますか？

仕様：GitHub仕様書
ホワイトペーパー：x402-whitepaper.pdf

x402はどのように進化していきますか？

GitHubのパブリックIssueとコミュニティRFCで追跡されています。主要なテーマとして、マルチアセットサポート・追加スキーム（upto、stream）・サービス検索・レピュテーション向けのディスカバリーレイヤーなどが含まれています。

なぜx402はCoinbaseのGitHubにホストされているのですか？

現在はCoinbaseの管理下に置くことで、社内のセキュリティ・監査チームを活用し、仕様の安全性と法的に問題のある支払いフローが誤って作られないようにするためです。将来的にはステアリンググループまたはオープンソース委員会へのリポジトリ移管を予定しています。

トラブルシューティング

PAYMENT-SIGNATUREを付けても402が返ってくる。なぜですか？

以下の点を確認してください：

署名が無効（チェーンIDまたはペイロードフィールドが間違っている）
支払い金額が支払い要件のamountと完全一致していない（exactスキームは過払い・不払い不可）
アドレスのUSDC残高が不足しているか、KYTでフラグが立てられている

サーバーのJSONレスポンスのerrorフィールドで詳細を確認してください。

Base SepoliaではテストできるがBase mainnetでは失敗する。何が違いますか？

network: "eip155:8453"（Base mainnet）を設定しているか確認してください（"eip155:84532"はBase Sepolia）
ウォレットにmainnetのUSDCがあることを確認してください
mainnetではガス代が高いため、少額のETHをウォレットに入金してください

まだ質問がありますか？

• Discordチャンネルでお気軽にどうぞ
• x402リポジトリでGitHub DiscussionまたはIssueを開く

← x402とはバイヤー向けクイックスタート →