意義
保留供日後使用,但實際上許多服務在需要付款或付費方案才能繼續時回傳它。
常見原因
- 訂閱已過期或付款失敗
- 付費方案的 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 即可。