HTTP 402 Payment Required：它的含义，以及 x402 如何使用它
402 是表示"请求需要先付费才能被服务器处理"的 HTTP 状态码。在它存在的大部分时间里，都没有标准格式。x402 补上了这一块。
Key takeaways
-
402 Payment Required 是一种客户端错误：请求本身是有效的，但服务器要求先付款。
-
HTTP/1.1 把 402 保留给未来使用，但从未定义支付应该如何运作，因此各个 API 对它的用法都不一样。
-
x402 补齐了缺失的部分：一个带有机器可读条款的 PAYMENT-REQUIRED 响应头，以及重试时的已签名支付。
402 Payment Required 是什么意思
402 响应告诉客户端：请求本身没有问题，但在付款之前不会被处理。它属于 4xx 家族，因为接下来需要采取行动的是客户端而不是服务器。
402 与 401 Unauthorized、403 Forbidden 不同。401 要求提供凭证，403 直接拒绝请求，而 402 要求付款。
为什么 402 闲置了这么久
这个状态码是在编写 HTTP/1.1 时保留的，当时预期某种形式的数字现金会在未来出现。但规范从未说明 402 的响应体应该包含什么，客户端应该如何付款，因此浏览器从未真正处理过它。
由于没有统一格式，那些确实返回 402 的 API 只是把它当作普通错误使用：账户额度用尽、银行卡被拒，或者达到了套餐限额。
现在 API 何时会返回 402
你会在两大类场景中见到 402。
- 账户计费错误：key 是有效的，但余额、额度或订阅无法覆盖这次请求。解决方法是充值或升级套餐。
- 按请求计费的报价：服务器返回支付条款，客户端付款后可以重试同一个请求。x402 就是这样运作的。
x402 如何把 402 变成一套支付流程
x402 把机器可读的条款放进 PAYMENT-REQUIRED 响应头：金额、资产、网络和收款地址。客户端针对这些条款签署一份稳定币授权，通过 PAYMENT-SIGNATURE 请求头回传，然后收到带有 PAYMENT-RESPONSE 收据的响应。
由于整个交互都是普通的 HTTP，拥有钱包的 AI 智能体无需注册或存储 API key，就能为一次 API 调用付款。
在客户端中处理 402
首先检查是否存在 PAYMENT-REQUIRED 响应头。如果存在，说明这是一个 x402 报价，x402 客户端可以完成支付。如果不存在，请阅读错误信息：通常意味着账户需要充值或更换套餐。
HTTP 402 常见问题
402 Payment Required 算是一种错误吗？
它是 4xx 范围内的一种客户端错误，但不代表请求格式有误。它的含义是：服务器要求先付款才会继续处理。
402 和 401 有什么区别？
401 表示服务器需要有效的凭证。402 表示服务器需要付款。同一个 API 可以对无效 key 返回 401，对余额不足的有效 key 返回 402。
浏览器会自动处理 402 吗？
不会。浏览器把 402 当作普通错误页面展示。自动付款需要一个理解 x402 这类协议的客户端。
哪些 API 会结合 x402 使用 402？
任何实现了 x402 协议的服务器都可以。RunAPI 在其按次计费的 AI 模型端点上返回 x402 报价，智能体因此可以用 USDC 支付图像、视频、音乐和音频生成。