クイックスタート

x402プロトコルとは

x402は、HTTP 402 Payment Requiredステータスコードを活用した決済プロトコルです。 サーバーが402レスポンスを返すと、クライアントは自動的にEIP-3009署名を生成し、 Facilitatorを経由してオンチェーン決済を実行します。yen402は、このプロトコルを 日本円ステーブルコイン（JPYC）で利用可能にしたインフラです。

基本的な流れ

1. Clientがx402対応サーバーにHTTPリクエストを送信
2. Serverが402 Payment Requiredを返す（金額・受取先を含む）
3. ClientがEIP-3009署名を生成し、PAYMENT-SIGNATUREヘッダー（base64）を付けてリトライ
4. ServerがFacilitatorの/verifyで署名・nonce・金額を検証（オンチェーン書き込みなし）
5. Serverが続けて/settleを呼び、FacilitatorがtransferWithAuthorizationをブロードキャスト
6. Serverがコンテンツ/データを返す（PAYMENT-RESPONSEヘッダーに settle 結果を base64 で同梱）

APIキー発行後は GET /payment-info（X-API-Keyヘッダー必須）で、DBに登録された受取アドレスをプログラマブルに確認できます。