O que significa
Reservado para uso futuro, mas na prática serviços o retornam quando é preciso um pagamento ou plano pago para continuar.
Causas comuns
- Assinatura expirada ou pagamento recusado
- Cota de API de um plano pago esgotada
- Stripe e outras APIs sinalizando uma cobrança recusada
Como resolver
Se você é o cliente ou visitante
Verifique o faturamento da conta, atualize a forma de pagamento ou faça upgrade do plano.
Se você mantém o site ou a API
Explique no corpo qual pagamento é necessário. Não há semântica padrão, então documente seu uso.
Resposta de exemplo
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."
}Especificação
Perguntas frequentes
› O 402 é padronizado?
Apenas reservado. A especificação não define o significado exato, então o comportamento varia entre serviços.
› 402 ou 403 para contas não pagas?
402 é mais claro quando o pagamento resolveria; 403 serve quando o acesso é negado por outros motivos.