4xx · Errores del cliente
Error 402 Payment Required: qué significa y cómo solucionarlo
El código 402 Payment Required estaba reservado para un futuro sistema de micropagos que nunca se estandarizó. Hoy lo usan algunas APIs y plataformas (Stripe, Shopify, servicios con cuota) para indicar que la cuenta no tiene saldo, la suscripción ha vencido o se ha superado el plan contratado.
Qué significa el código 402
No hay un comportamiento estándar: cada servicio lo usa a su manera. Si lo recibes de una API, revisa el cuerpo de la respuesta y el panel de facturación del proveedor.
Causas habituales del error 402
- Tarjeta rechazada o suscripción caducada en un servicio SaaS.
- Cuota de uso agotada en el plan gratuito de una API.
- Tienda de Shopify con pagos pendientes.
Cómo solucionar el error 402
- Revisa el estado de facturación de la cuenta en el proveedor.
- Si eres tú quien diseña la API, 402 es aceptable para "plan agotado", pero documenta su significado.
Ejemplo de respuesta
http
HTTP/1.1 402 Payment Required
Content-Type: application/json
{"error": "quota_exceeded", "detail": "Has superado las 10 000 peticiones de tu plan"}Preguntas frecuentes
¿El 402 lo ven los navegadores de alguna forma especial?
No. Los navegadores lo tratan como cualquier otro error 4xx y muestran lo que devuelva el servidor.