TrueURL
TrueURL

選單

402 需要付款

HTTP 保留供日後使用的狀態碼。實務上,有些 API 和服務會在需要付款、點數或訂閱時使用它。

原因短語
Payment Required
是否為重新導向
否
預設可快取
否

402 Payment Required 在 HTTP/1.1 中保留供日後使用,當初設想的是數位支付系統。RFC 9110 至今仍只說它「保留供日後使用」,沒有任何標準意義、標頭或付款流程與它相關。

由於標準沒有實際使用它,有些服務便依自身需求採用:付款 API 在扣款失敗時使用它,SaaS API 在方案的點數或配額用盡時使用它,代管平台則在帳戶因未付款而停權時使用它。近來,針對 AI 爬蟲付費存取及機器對機器小額付款的機制,也開始以 402 告訴用戶端存取需要付費。

沒有特別處理的用戶端會將 402 視為一般的用戶端錯誤。

回應範例

HTTP
HTTP/1.1 402 Payment Required
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/json
Content-Length: 90

{"error":{"type":"card_error","code":"card_declined","message":"Your card was declined."}}

SEO 與重新導向檢查

對搜尋引擎而言,402 是 4xx 錯誤,因此網址不會被編入索引。如果您販售內容的存取權,又希望內容出現在搜尋結果中,請不要對爬蟲回傳 402;請以 200 提供網頁,並使用結構化資料(isAccessibleForFree)標示付費牆內的部分。有些 CDN 功能會刻意對 AI 爬蟲回應 402,這不會影響您允許的搜尋引擎爬蟲。

常見原因與使用情境

  • 付款 API 回報信用卡遭拒或扣款失敗。
  • API 金鑰的方案點數已用完,或已超出付費配額。
  • 代管的網路商店或網站因帳戶未付款而遭停權。
  • 按次檢索付費(pay-per-crawl)或小額付款機制要求用戶端先付款才能存取。

網址重新導向檢查

使用免費的 TrueURL 重新導向檢查工具,逐一查看網址在每個躍點回傳的狀態碼。