Reservado; algunas API lo usan para problemas de facturación.
Cuándo usarlo
Límite del plan alcanzado o pago fallido.
Causas habituales y soluciones
402 se reservó para uso futuro y nunca se estandarizó, así que su significado depende de la API. Stripe devuelve 402 cuando se rechaza una tarjeta o falla un cobro, con el motivo en el cuerpo del error, y Shopify lo devuelve cuando una tienda está congelada por facturas impagadas. Otras API SaaS lo usan cuando termina un periodo de prueba o se alcanza un límite del plan. Lee el código de error del cuerpo, no solo el estado.
No reintentes un 402 automáticamente: no se resolverá hasta que alguien actualice los datos de facturación o mejore el plan, así que muéstraselo a una persona con un enlace a la página de facturación. Si diseñas una API, 402 es una opción razonable para los bloqueos por facturación, distinta de 403 para permisos y de 429 para límites de frecuencia, pero documéntalo, porque los clientes genéricos lo tratan simplemente como un error 4xx desconocido.
Error del cliente (4xx)
Los códigos 4xx son errores del cliente: la solicitud en sí es incorrecta, no está autorizada o apunta a algo que no existe. Repetir la misma solicitud no servirá de nada.
Cómo se ve
HTTP/1.1 402 Payment RequiredCómo enviarlo
| Node.js / Express | res.status(402).end() |
|---|---|
| Python / Flask | return '', 402 |
| nginx | return 402; |
Cómo comprobarlo
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/