Solucionar errores de licencia y de dominio
Cuando la validación falla, el panel Licencia muestra una cruz roja seguida de un código de error corto. Esta página explica qué significa cada código y qué hacer al respecto.
Lee primero el panel
Abre Settings → POM AI → License. La línea Status es el estado local autorizado:
- una marca verde y una palabra de estado significan que la última comprobación se realizó correctamente;
- una cruz roja y un código significan que no fue así, y el código es lo que consultas más abajo.
Anota el código con exactitud. Los códigos son estables; el texto que los rodea puede estar traducido.
Problemas de clave y de suscripción
| Código | Significado | Qué hacer |
|---|---|---|
missing_license_key |
No se envió ninguna clave | Pega la clave y guarda |
invalid_license_key |
La clave no se reconoce | Vuelve a copiarla desde My Account → Licenses & Downloads; comprueba que no se haya pegado truncada. Si se ha rotado, la clave antigua ya no existe |
license_inactive |
La licencia no está activa — normalmente suspendida | Consulta el estado de pago de la suscripción en la cuenta |
license_expired |
La fecha de pago ha vencido | Renueva y, a continuación, selecciona Revalidate |
product_mismatch |
La clave pertenece a otro producto de POM | Usa la clave de POM AI, no la de otro producto |
reconnect_required |
La clave almacenada ya no se puede descifrar | Pega la clave de nuevo; esto ocurre tras un cambio de salt de WordPress |
license_expired y license_inactive se vuelven a comprobar con la suscripción antes de notificarse, de modo que una renovación que acaba de completarse normalmente se detecta en el siguiente intento. Si no es así, usa Revalidate para forzar una comprobación nueva.
Problemas de dominio
| Código | Significado | Qué hacer |
|---|---|---|
domain_not_authorized |
Este host no está autorizado para esta licencia | Guarda la clave en este sitio o añade el dominio desde la cuenta |
domain_limit_reached |
La capacidad de dominios del plan está completa | Libera una plaza o mejora el plan |
network_not_authorized |
La licencia está vinculada a una red de WordPress diferente | Usa la clave en su propia red o contacta con soporte sobre la revinculación |
local_domain_not_allowed |
El plan no permite hosts locales o de desarrollo | Usa un host de staging o de producción, o un plan que permita local |
invalid_domain |
El host enviado no se pudo analizar, no tiene punto, contiene caracteres no válidos o es una dirección IP en un plan que las prohíbe | Introduce el host simple, como example.com |
domain_blocked |
El dominio fue bloqueado administrativamente para esta licencia | Contacta con soporte |
domain_not_authorized también aparece cuando el host está autorizado bajo una licencia diferente del mismo producto. El mensaje dice que el dominio ya está autorizado bajo otra licencia: desactívalo allí primero o contacta con soporte si no es tuyo.
La causa más frecuente de domain_not_authorized, sin embargo, es un sitio que se ha movido. Compara la línea Domain con el host real del sitio. Consulta Autorizar un dominio para usar POM AI.
Problemas de plan y de operación
| Código | Significado | Qué hacer |
|---|---|---|
operation_not_allowed |
El plan no incluye esta capacidad — operaciones de créditos de IA, actualizaciones o descargas | Consulta el plan en la cuenta |
feature_not_allowed |
El plan no incluye la característica solicitada | Igual que arriba |
plan_not_found / plan_misconfigured |
La configuración del plan en la cuenta es incoherente | Contacta con soporte; esto no se puede solucionar desde el sitio |
Limitación de frecuencia
| Código | Significado | Qué hacer |
|---|---|---|
rate_limited |
Demasiados intentos de validación o activación | Espera y prueba una vez. No reintentes en bucle |
Los intentos repetidos de guardado con una clave incorrecta son el desencadenante habitual. Detente, obtén la clave correcta y haz un único intento.
Problemas de transporte
| Código | Significado | Qué hacer |
|---|---|---|
network_error |
No se pudo alcanzar el servidor de la cuenta, o devolvió algo ilegible | Comprueba el HTTPS saliente desde el servidor; comprueba si hay un proxy eliminando cabeceras |
licensing_unavailable |
El servicio de la cuenta no puede responder temporalmente | Reintenta más tarde; contacta con soporte si persiste |
invalid_signature |
La solicitud no se pudo verificar | Comprueba el reloj del servidor; un desfase de reloj grande es la causa habitual |
Un network_error se trata como transitorio. No se registra como fallo de validación, no borra la clave almacenada y no activa una advertencia de licencia. Una licencia previamente válida también sigue funcionando durante una interrupción breve de la cuenta.
Eso significa que un sitio cuya pestaña License sigue mostrando un estado válido pero cuya IA se ha detenido es casi con seguridad un problema de conectividad o de créditos, no un problema de licencia.
Avisos locales
Dos mensajes provienen del sitio y no de la cuenta:
- The license could not be stored. La clave se validó pero su escritura local falló. Comprueba que la base de datos permite escritura y reintenta.
- The license server could not deactivate this domain. The local key was kept so you can try again safely. Un intento de desvinculación no pudo alcanzar la cuenta. Reintenta cuando vuelva la conectividad o, en su lugar, elimina el dominio de la cuenta. Consulta Eliminar un dominio autorizado.
Síntomas sin código
| Síntoma | Causa probable |
|---|---|
| El saldo de créditos nunca carga, pero la licencia es válida | HTTPS saliente bloqueado, o un plugin de seguridad bloqueando admin-ajax.php |
| El saldo carga pero todas las operaciones fallan | El saldo es cero, o el plan no incluye operaciones de créditos |
| Aparece una advertencia de licencia en un subsitio mientras la clave de red es válida | Comportamiento correcto: el subsitio necesita su propia clave. Consulta Configurar POM AI en WordPress multisitio |
| Nunca aparece una actualización del plugin | La clave de red, o que POM AI no esté activo en la red. Consulta Entender la licencia de red usada para las actualizaciones |
| La pestaña License no es visible | La cuenta no tiene derechos de administrador |
Un orden de investigación eficaz
- Lee la línea Status y anota el código.
- Compara la línea Domain con el host real del sitio.
- Prueba Revalidate una vez.
- Comprueba el estado de la suscripción en account.pom.es.
- Comprueba la lista de dominios autorizados y el recuento de usados sobre el total.
- Comprueba que el servidor puede alcanzar el host de la cuenta en absoluto.
- Solo entonces contacta con soporte.
Informar a soporte
Incluye la URL del sitio, si es de sitio único o multisitio, la versión de POM AI, el código exacto, la línea Domain tal como se muestra, la hora y qué acababas de hacer.
No incluyas nunca la propia clave de licencia, una clave de API de MCP, un token de OAuth ni un código de autorización. Soporte no los necesita, y enviar uno significa que tendrá que rotarse después.