x402 リソースセンター

HTTP 402 および x402 プロトコルに関する完全ガイド:ドキュメント、チュートリアル、ホワイトペーパー、開発者向けリソース。

x402 リソースセンターへようこそ

Pay-per-use(従量課金)の API を実装したい開発者、コンテンツを収益化したいクリエイター、自律的な決済機能を構築する AI エージェント開発者のいずれであっても、このリソースハブには x402 と HTTP 402 を始めるために必要なすべてが揃っています。

x402 プロトコルは、長らく使われていなかった HTTP 402 ステータスコードを、強力で実用的な決済メカニズムへと変貌させます。以下に、トピックや習熟度別に整理された公式ドキュメント、コードサンプル、統合ガイド、コミュニティリソースを掲載しています。

🚀 クイックスタート

x402 は初めてですか?まずはここから始めて、基本を理解し、数分以内に最初の統合を稼働させましょう。

x402 とは何ですか?

V2 機能、ウォレット認証、マルチチェーン対応など、x402 プロトコルの包括的な紹介。

HTTP 402 とは何ですか?

HTTP 402 ステータスコードの歴史、他のステータスコードとの比較、そしてなぜ今活用され始めているのかについての詳細な解説。

USDC で支払う方法

ユーザー向けのステップバイステップガイド:ウォレットの設定、USDC の取得、そして最初の x402 決済を行う方法。

📚 公式ドキュメント

x402 プロトコルチームおよびウェブ標準化団体による信頼できるリソースです。

x402 公式サイト

プロトコルの概要、エコシステムのアップデート、ライブデモ、オンボーディングガイド。x402 に関するニュースと発表の主要な情報源です。

x402 ホワイトペーパー (PDF)

プロトコルの設計、ワークフローの詳細、セキュリティ上の考慮事項、実装ガイドラインを網羅した詳細な技術仕様書。

x402 GitHub リポジトリ

オープンソースのリファレンス実装、SDK コード、サンプルアプリケーション、貢献のためのガイドライン。

🔧 開発者ツールと SDK

x402 をアプリケーションに迅速かつ安全に統合するためのライブラリとツールです。

サーバーサイドライブラリ

言語 パッケージ名 説明
Node.js @x402/server エンドポイントを 402 決済ゲートで保護するための Express/Fastify ミドルウェア
Python x402-python ビューに支払い要件を追加するための Django/Flask デコレータ
Go x402-go Go ウェブフレームワーク用 HTTP ミドルウェア
Rust x402-rs 非同期決済検証を備えた Actix/Axum ミドルウェア

クライアントサイドライブラリ

プラットフォーム パッケージ名 説明
JavaScript/TypeScript @x402/client 402 レスポンスの処理とウォレット署名のためのブラウザおよび Node.js クライアント
React @x402/react 決済フローのための React フックとコンポーネント
Python x402-requests 402 自動処理機能を備えた Requests ライブラリの拡張

📖 統合ガイド

一般的な統合シナリオのためのステップバイステップのチュートリアルです。

API 収益化ガイド

REST または GraphQL API に Pay-per-call(従量課金)を追加する方法を学びます。レート制限、価格設定階層、利用分析を網羅しています。

  • 決済エンドポイントの設定
  • 価格設定ポイントの設定
  • 決済検証の処理
  • 利用状況ダッシュボードの作成

コンテンツペイウォール統合

サブスクリプションなしで、記事、動画、ダウンロードに対するマイクロペイメントを実装します。

  • サーバーサイドのコンテンツ保護
  • クライアントサイドのアンロックフロー
  • 有料コンテンツのキャッシュ
  • 収益トラッキング

AI エージェント決済の設定

自律型エージェントが有料リソースにアクセスし、人間の介入なしに支払いを行えるようにします。

  • エージェントウォレットの設定
  • 402 レスポンスの自動処理
  • 予算制限とコントロール
  • 決済のロギングと監査

マルチチェーン設定

Ethereum、Base、Polygon、Arbitrum など、複数のブロックチェーンでの支払いを受け付けます。

  • チェーン固有の設定
  • USDC コントラクトアドレス
  • ガス代最適化戦略
  • クロスチェーン決済

🌐 HTTP 標準とリファレンス

HTTP ステータスコードと決済プロトコルに関する公式のウェブ標準ドキュメント。

MDN: 402 Payment Required

ブラウザの互換性や使用上の注意を含む、402 ステータスコードに関する Mozilla Developer Network の完全なリファレンス。

RFC 9110: HTTP Semantics

予約済みステータスコードとしての 402 の定義を含む、IETF による公式 HTTP 仕様書。

Wikipedia: HTTP ステータスコード

歴史的背景、402 開発のタイムライン、長年にわたる実装の試みの概要。

HTTP ステータスコードリファレンス

すべての HTTP ステータスコードに関する解説と関連コードのクイックリファレンス。

💰 USDC とステーブルコインのリソース

x402 トランザクションを支える決済レイヤーについて理解しましょう。

Circle 社の USDC

x402 決済で使用される、ドルに裏打ちされたステーブルコイン USDC の公式ドキュメント。準備金、監査、サポートされているチェーンについて学びます。

Circle 開発者ドキュメント

API リファレンス、SDK、ベストプラクティスを含む、USDC 統合のための技術ドキュメント。

サポートされているチェーン

x402 は、最大限の柔軟性のために複数のネットワークで USDC をサポートしています。

  • Ethereum メインネット - オリジナルであり、最も流動性の高い市場
  • Base - 手数料が安い Coinbase の L2
  • Polygon - 高速で安価なトランザクション
  • Arbitrum - 強力な DeFi エコシステムを持つ Ethereum L2
  • Optimism - もう一つの人気のある Ethereum L2

🎓 学習パス

役割や目標に合わせた体系的な学習のロードマップです。

API 開発者向け

  1. HTTP 402 とは何ですか? を読み、ステータスコードを理解する
  2. プロトコルの仕組みについて x402 とは何ですか? を学習する
  3. 技術的な詳細について ホワイトペーパー を確認する
  4. GitHub で サンプル実装 を探索する
  5. 開発環境でテストエンドポイントを実装する
  6. 適切なモニタリング体制を整えて本番環境にデプロイする

コンテンツクリエイター向け

  1. ユーザーの視点から 決済がどのように機能するか を理解する
  2. セッションの再利用を含む x402 V2 の機能 について学ぶ
  3. x402 をサポートするプラットフォームまたは CMS を選択する
  4. コンテンツの価格設定を行う
  5. 決済通知と分析を設定する

AI エージェント開発者向け

  1. プログラムによる処理のために x402 プロトコルフロー を学習する
  2. 適切な支出制限を設定してエージェントウォレットを構成する
  3. 402 レスポンスの自動検出を実装する
  4. 決済の意思決定ロジックを構築する
  5. ロギングと予算監視機能を追加する

🔗 コミュニティとサポート

x402 コミュニティとつながり、必要なときに助けを求めましょう。

GitHub Discussions

質問をしたり、実装を共有したり、プロトコルの改善についてコミュニティと議論したりしましょう。

議論に参加する →

Stack Overflow

x402 の実装に関する技術的な Q&A です。注目を集めるために [x402] タグを使用してください。

質問を見る →

Twitter/X コミュニティ

お知らせ、ヒント、エコシステムのニュースについては @x402protocol をフォローしてください。

お問い合わせ

このドキュメントに関する質問がありますか? [email protected] までご連絡ください。

📋 比較:x402 vs 従来の決済ソリューション

x402 が既存の決済統合オプションとどのように異なるかを理解しましょう。

機能 x402 Stripe/PayPal 手動の仮想通貨決済
マイクロペイメント (1ドル未満) ✅ 効率的 ❌ 手数料が非常に高い ⚠️ ガス代が変動する
アカウント不要 ✅ ウォレットのみ ❌ アカウント必須 ✅ ウォレットのみ
マシン間 (M2M) ✅ ファーストクラスの対応 ❌ 非対応 ⚠️ 複雑
HTTP ネイティブ ✅ 402 ステータスコード ❌ リダイレクト ❌ カスタムフロー
グローバルアクセス ✅ 許可不要 ⚠️ 地域制限あり ✅ 許可不要
即時決済 ✅ ブロックチェーン ❌ 数日の遅延 ✅ ブロックチェーン

🛡️ セキュリティのベストプラクティス

x402 を実装する際の重要なセキュリティ上の考慮事項です。

📊 分析とモニタリング

x402 決済の実装を追跡し、最適化しましょう。

❓ よくある質問

x402 は本番環境で使用できますか?

はい、x402 V2 は本番環境に対応しており、複数のアプリケーションで使用されています。このプロトコルは Coinbase によってサポートされており、広範なテストが行われています。

取引手数料はいくらですか?

手数料は使用されるブロックチェーンによって異なります。Base や Polygon は 1 セント未満の手数料を提供していますが、Ethereum メインネットは 1 取引あたり数ドルのコストがかかる場合があります。

複数の通貨を受け入れることはできますか?

現在、x402 はシンプルさとコンプライアンスのために USDC に重点を置いています。複数通貨のサポートはロードマップに含まれています。

返金はどのように行われますか?

返金はアプリケーションレベルで管理されます。決済はオンチェーンで行われるため、ユーザーのウォレットに返金するための別のトランザクションを送信することになります。

KYC は必要ですか?

x402 は許可不要(パミッションレス)です。ユーザーに KYC は不要です。ただし、加盟店としては、管轄区域によってはコンプライアンスの義務が生じる場合があります。