TrueURL
TrueURL

메뉴

402 결제 필요

HTTP가 향후 사용을 위해 예약해 둔 코드입니다. 실제로는 일부 API와 서비스가 결제, 크레딧, 구독이 필요할 때 사용합니다.

사유 구절
Payment Required
리디렉션 여부
아니요
기본 캐시 가능 여부
아니요

402 Payment Required는 디지털 결제 시스템을 염두에 두고 HTTP/1.1에서 향후 사용을 위해 예약되었습니다. RFC 9110도 여전히 “향후 사용을 위해 예약됨”이라고만 밝히고 있습니다. 표준으로 정해진 의미나 헤더, 결제 흐름은 없습니다.

표준이 이 코드를 비워 두었기 때문에 일부 서비스는 자체 용도로 이를 채택했습니다. 결제 API는 결제가 실패했을 때, SaaS API는 요금제의 크레딧이나 할당량이 소진되었을 때, 호스팅 플랫폼은 미납으로 계정이 정지되었을 때 402를 사용합니다. 최근에는 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 오류이므로 해당 URL은 색인되지 않습니다. 콘텐츠 접근을 유료로 판매하면서도 검색에 노출되기를 원한다면 크롤러에 402를 반환하지 마세요. 페이지는 200으로 제공하고, 페이월이 적용된 부분은 구조화된 데이터(isAccessibleForFree)로 표시하세요. 일부 CDN 기능은 의도적으로 AI 크롤러에 402로 응답하는데, 이는 허용한 검색 크롤러에는 영향을 주지 않습니다.

주요 원인과 사용 사례

  • 결제 API가 카드가 거절되었거나 결제가 실패했다고 알립니다.
  • API 키의 요금제 크레딧이 소진되었거나 유료 할당량을 초과했습니다.
  • 호스팅된 쇼핑몰이나 웹사이트가 계정 미납으로 정지되었습니다.
  • 크롤링당 과금(pay-per-crawl)이나 소액 결제 방식이 접근 전에 결제를 요구합니다.

URL 리디렉션 검사

무료 TrueURL 리디렉션 검사 도구로 URL이 반환하는 모든 상태 코드를 홉별로 확인하세요.