의미
향후 사용을 위해 예약되어 있지만, 실제로는 결제나 유료 요금제가 필요할 때 서비스들이 반환합니다.
흔한 원인
- 구독 만료 또는 결제 실패
- 유료 요금제의 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이면 됩니다.