📨 Error 402 – Pago Requerido

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.