> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doconda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Licencia y dominios

> Plan mensual, anual o de pago único, con 7 días gratis. Una clave de licencia que solo abre el editor en tus dominios.

## Contratar

En el panel, **Facturación → Plugin de editor**, eliges un plan y pagas en Stripe, por organización: documentos y
usuarios ilimitados. Solo el propietario de la organización puede contratarlo. El panel muestra el precio de cada
plan, con IVA incluido, antes de pagar.

| Plan | Cómo se paga |
| - | - |
| Mensual | Cada mes; se cancela cuando quieras desde **Facturas y tarjeta** (el portal de Stripe). |
| Anual | Una vez al año; se cancela igual. |
| Pago único | Una sola vez; la licencia no caduca. Si tenías un plan mensual o anual, se cancela solo. |

Desde la API: `POST /v1/editor/subscribe` con `{ "plan": "monthly" | "yearly" | "perpetual" }`.

### Prueba gratis de 7 días

La primera vez que una organización contrata el plan mensual o el anual, los **7 primeros días son gratis**. Pones la
tarjeta en Stripe, pero hoy no se cobra nada; el panel muestra «prueba gratis hasta el …». Al acabar la prueba se cobra
el primer periodo y la suscripción sigue sola. El pago único no tiene prueba: para probar, usa localhost o el plan
mensual. Si cancelas antes, no pagas nada y el editor deja de abrir al terminar la prueba. Durante la
prueba tienes todo: clave, dominios y enlace de instalación. Hay una prueba por organización.

Al activarse, el panel te da:

* una **clave de licencia** (`ek_eu_…` o `ek_us_…`), que pasas en `licenseKey`;
* una lista de **dominios** donde el editor se puede abrir.

## Dominios

Hasta **5**. Cada uno es un nombre de host:

| Escribes | Abre en |
| - | - |
| `app.tuempresa.com` | Solo `https://app.tuempresa.com` |
| `*.tuempresa.com` | Cualquier subdominio: `app.tuempresa.com`, `eu.tuempresa.com`… (no `tuempresa.com`: añádelo aparte) |

Solo en **https**. Sin `https://` ni rutas: `app.tuempresa.com`, no `https://app.tuempresa.com/editor`.

En `localhost`, `127.0.0.1` y `*.localhost` el editor **abre siempre**, con o sin clave, y muestra el aviso
«licencia de desarrollo». Así puedes programar sin gastar dominios.

## Qué pasa al abrirse

1. El editor pide a Doconda un permiso para la web donde está (`POST /v1/editor/token?key=…`). La dirección de tu web
   la pone el navegador; la página no puede cambiarla.
2. Doconda comprueba que la clave existe, que la suscripción está pagada y que la web está en tus dominios.
3. Si todo está bien, devuelve un permiso **firmado** para esa web, que dura **1 hora**. El editor comprueba la
   firma, lo guarda en el navegador y lo renueva solo en segundo plano. Si te quedas sin conexión mientras editas,
   sigue funcionando.

Sin permiso válido, el editor no abre el archivo: muestra «Este editor necesita una licencia de Doconda» y llama a
`onError("editor_unlicensed")`.

Por eso tu clave puede ir en el código de tu web: fuera de tus dominios no sirve.

## Renovaciones y bajas

| Situación | El editor |
| - | - |
| Suscripción al día | Abre |
| No se pudo cobrar la renovación | Sigue abriendo **7 días** mientras actualizas la tarjeta; el panel lo avisa |
| Cancelada | Deja de abrir en menos de 1 hora, también en las pestañas que ya estaban abiertas |

## Cambiar la clave

**Facturación → Plugin de editor → Cambiar**. La clave anterior deja de funcionar al momento (los permisos que ya
estaban dados caducan en menos de 1 hora). También cambia el enlace de instalación. Cámbiala en tu código.

## Cómo protegemos el plugin

* Se entrega **compilado y ofuscado**, nunca el código fuente, por un enlace de instalación personal que solo
  funciona con la licencia activa.
* Cada copia lleva una **marca de la organización** que la descargó. Si una copia aparece en uso con la licencia de
  otra organización, Doconda lo sabe.
* La licencia se comprueba al abrir, al pintar el editor y al guardar, y se renueva cada hora.
* Los [términos de uso](https://doconda.com/terms) prohíben descompilarlo, saltarse la licencia, quitar la marca o seguir usándolo al
  terminar la suscripción.

## Errores

| Código | Qué significa |
| - | - |
| `editor_unlicensed` | La clave no existe, la suscripción no está activa o la web no está en tus dominios |
| `editor_already_active` | Ya tienes el plugin contratado |
| `editor_inactive` | No puedes cambiar la clave sin una suscripción activa |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.