El código 402 Payment Required indica que el acceso a un recurso o servicio está restricto hasta que se realice un pago.
Aunque originalmente fue reservado para futuras funciones del protocolo HTTP, hoy se usa principalmente en sistemas de pago, APIs, suscripciones y contenido premium.
Causas más comunes
-
El usuario intentó acceder a contenido o servicio que requiere pago.
-
La suscripción del usuario venció o está impaga.
-
API o servicio externo exige un plan premium o créditos para continuar.
-
Límite de consumo superado (ej: planes por tokens, consultas o ancho de banda).
-
Configuración del sistema que bloquea funciones hasta completar un pago.
-
Sistema de checkout incompleto, donde no se validó correctamente la transacción.
Soluciones recomendadas
1) Verificar el estado del pago o suscripción
Comprueba si el usuario:
-
Tiene un plan activo
-
Completó el pago
-
No excedió los límites permitidos
En plataformas SaaS y servicios digitales es la causa más frecuente.
2) Revisar la integración con la pasarela de pagos
Si usas Stripe, PayPal, Culqi, MercadoPago u otra, asegúrate de:
-
El webhook esté funcionando correctamente
-
La transacción haya sido confirmada
-
No existan errores de validación en la respuesta de la API
3) Corregir lógicas internas del sistema
En aplicaciones personalizadas, el error puede activarse cuando:
-
El sistema no reconoce el pago
-
La base de datos no actualiza el estado de la suscripción
-
Existen condiciones mal configuradas (ej. “créditos ≤ 0”)
4) Asegurar que el contenido protegido esté bien configurado
Si usas WordPress con plugins como MemberPress, WooCommerce Memberships, Restrict Content Pro:
-
Revisa reglas de acceso
-
Corrige niveles de membresía
-
Asegúrate de que el usuario esté asignado al plan correcto
5) Verificar límites de consumo en APIs
Muchos servicios devuelven 402 cuando:
-
No quedan créditos disponibles
-
El plan gratuito llegó al tope
-
El endpoint requiere una versión de pago
Ejemplo de cabecera típica:
Consejo Pro
Ofrece una página de pago amigable cuando ocurra un 402:
-
Explica por qué se bloqueó el acceso
-
Muestra el estado del plan
-
Incluye un botón directo de renovación o compra
Esto mejora la conversión y reduce la frustración del usuario.
