含义
保留供将来使用,但实际上很多服务在需要付款或付费套餐才能继续时返回它。
常见原因
- 订阅已过期或付款失败
- 付费套餐的 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."
} 规范
常见问题
› 402 是标准化的吗?
只是被保留。规范没有定义其确切含义,因此各服务的行为不同。
› 未付费账户应该返回 402 还是 403?
付款就能解决时 402 更清楚;因其他原因拒绝访问时用 403 即可。