DevToolPal
简
4xx 客户端错误

402 Payment Required

需要付款

含义

保留供将来使用,但实际上很多服务在需要付款或付费套餐才能继续时返回它。

常见原因

  • 订阅已过期或付款失败
  • 付费套餐的 API 配额已用完
  • Stripe 等 API 表示扣款被拒

解决方法

客户端或访问者

检查账户账单,更新付款方式或升级套餐。

网站或 API 的维护者

在响应体中说明需要支付什么。它没有标准语义,请在文档中写明你的用法。

响应示例

HTTP/1.1
HTTP/1.1 402 Payment Required
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "Payment Required",
  "status": 402,
  "detail": "Your plan has no build minutes left this month."
}

规范

RFC 9110 §15.5.3

常见问题

› 402 是标准化的吗?

只是被保留。规范没有定义其确切含义,因此各服务的行为不同。

› 未付费账户应该返回 402 还是 403?

付款就能解决时 402 更清楚;因其他原因拒绝访问时用 403 即可。