誤り | Proxy-seller

x402 APIは実際のHTTPステータスコードを使用します。すべてのエラーには同じJSONボディがあり、retry_action 担当者に次に何をすべきかを伝えます。

エラー本文

名前	種類	説明
エラー	文字列	エラーコードについては、以下の表を参照してください
メッセージ	文字列	人間が読みやすい短いメッセージ
再試行可能	ブール値	繰り返しは役立つか
retry_action	文字列	作業内容：`resign`,`retry_same_payment`,`poll`,`wait_and_retry`,`abandon`,`human_required`
retry_after_seconds	整数	再試行するタイミング；以下に等しい`Retry-After` ヘッダー
payment_state	文字列	`unused`,`in_flight` または`settled` — 資金が持ち出されたかどうか（再試行と冪等性)
authorization_expires_at	文字列	承認が有効である期限まで。それ以前に新しい承認書に署名しないでください。
order_id、operation_id、poll_url	文字列	支払いに関連する順序および操作（該当する場合）
bound_wallet	文字列	`quote_bound_to_other_wallet`: 引用文を収める財布
facilitator_reason	文字列	支払い確認の失敗理由（固定リストから選択）、または`unknown`
詳細	文字列	詳細（例：無効なフィールドのパスなど）：`/items/0/qty: …`

新しい引用を含む回答（quote_expired,payment_expired,quote_bound_to_other_wallet) には引用フィールドとPAYMENT-REQUIRED ヘッダー。

{
    "error": "payment_not_settleable",
    "message": "The presented authorization can still be settled",
    "retryable": true,
    "retry_action": "wait_and_retry",
    "retry_after_seconds": 512,
    "payment_state": "unused",
    "authorization_expires_at": "2026-11-02T10:16:00Z"
}

アクションの再試行

retry_action	作業内容
`resign`	この回答に記載された新しい要件に署名してください（`PAYMENT-REQUIRED`）、またはリクエストを修正してください
`retry_same_payment`	同じリクエストを、同じ`PAYMENT-SIGNATURE`。新しい記事には署名しないでください
`poll`	In`202` 回答：投票`poll_url`
`wait_and_retry`	最初からやり直す（新しい引用、新しい署名）のは、以下の日時より前にならないようにしてください。`retry_after_seconds`
`abandon`	同じ依頼を繰り返しても意味がありません
`human_required`	サポートにお問い合わせください。新しい承認には署名しないでください。

エラーコード

エラー	HTTP	retry_action	いつ
`payment_required`	402	`resign`	有料エンドポイントが呼び出されましたが、`PAYMENT-SIGNATURE`: 引用文は回答内にあります
`payment_invalid`	402	`abandon`	支払いヘッダーの形式が不正であるか、x402バージョン2に準拠していません（`X-PAYMENT` （バージョン1を含む）；ネットワーク、アセット、受取人、金額、または有効期間の誤り；署名検証に失敗しました；別のウォレットによる更新またはトラフィックの支払い
`insufficient_funds`	402	`wait_and_retry`	ウォレットのUSDC残高が不足しています。ウォレットにチャージし、認証が有効な間に同じリクエストを繰り返してください。
`quote_expired`	402	`resign`	見積もりの有効期限が切れているか、すでに支払いが完了しており、お客様の承認も期限切れとなっています。新しい見積もりが返信に含まれています。
`payment_expired`	402	`resign`	認証は未使用のまま期限切れになったか、キャンセルされました。何も奪われていません。応答には新しい見積もりが含まれています。
`invalid_request`	400	`abandon`	無効なフィールド、不明なフィールド、無効なJSON、ボディが64 KiBを超えている；国、期間、数量、ティア、パッケージ、またはオプションが利用不可；2つ目の住宅用パッケージ；特定のエンドポイントのルール
`terms_not_accepted`	400	`resign`	`accept_terms` バージョンは最新ではありません。本文には以下の内容が含まれています。`offer_version` および`privacy_version`
`purpose_not_allowed`	403	`abandon`	`intended_use` カタログリストにありません
`wallet_rejected`	403	`abandon`	ウォレットがブロックされているか、制裁リストに登録されています
`unauthorized`	401	`abandon`	いいえ`Authorization: Bearer x402_…` ヘッダー；ウォレットの署名がチャレンジと一致しません
`order_not_found`	404	`abandon`	その順序は存在しないか、そのトークンはその順序に対して無効です
`not_found`	404	`abandon`	「トップアップ」または「チャレンジ」が存在しないか、そのトークンが利用できない
`payment_replayed`	409	`abandon`	同じ認証情報（支払者とノンス）で、異なるコンテンツが表示された
`payment_not_settleable`	409	`wait_and_retry`	引用はすでに無効ですが、承認処理は引き続き実行可能です。次の状態になるまでお待ちください。`authorization_expires_at` 新しい契約に署名する前に
`payment_under_review`	409	`human_required`	お支払いは現在、弊社スタッフにより審査中です
`quote_bound_to_other_wallet`	409	`resign`	別のウォレットがすでにこの引用を使用しています。新しい引用が返信に含まれています。
`quote_payment_in_progress`	409	`wait_and_retry`	この見積もりに関する別の支払いが処理中です
`quote_config_mismatch`	409	`abandon`	有料依頼の本文が見積内容と一致していない、または有料承認の重複により別の依頼が発生している
`idempotency_key_conflict`	409	`abandon`	あなたのウォレットはすでにこれを使用しています`idempotency_key` 過去24時間以内に別の支払いがあった場合
`rate_limited`	429	`wait_and_retry`	制限を超えました (制限事項)
`settlement_retry`	503	`retry_same_payment`	お支払いの処理がまだ進行中です。同じリクエストを再度`retry_after_seconds`
`channel_paused`	503	`wait_and_retry`	現在、当サービスでは新規のお支払いを一時的に受け付けておりません
`dependency_unavailable`	503	`wait_and_retry`	一時的な不具合：価格、カタログ、支払い確認、またはその他のサービスが利用できません
`internal_error`	500	`wait_and_retry`	予期せぬエラー

誤ったHTTPメソッドが返されると405 コード付きinvalid_request.

本サービスからのすべての回答には、X-Request-Id ヘッダー。問題を報告する際は、これをサポートチームに伝えてください。

誤り

エラー本文

アクションの再試行

エラーコード

On this page