错误 | 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`	在`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；国家/地区、时段、数量、等级、套餐或选项不可用；第二个住宅套餐；特定端点的规则
`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`	相同的授权信息（付款方和非ce）却对应了不同的内容
`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