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

# Configura los dominios de tu tienda

> Cambia el subdominio Riqra de tu tienda y conecta tu propio dominio con los registros DNS que te indica el panel.

Tu tienda siempre responde en un subdominio Riqra, por ejemplo `acme.tiendariqra.com`. Además puedes conectar un dominio propio, como `acme.com` o `tienda.acme.com`. Mientras el dominio propio no esté verificado, el subdominio Riqra es la dirección oficial de la tienda. Cuando se verifica, tu dominio pasa a ser la dirección oficial y el subdominio Riqra redirige a él.

Los administras en **[Configuración → Dominios](https://app.riqra.com/settings/domains)**, dentro del grupo **Tienda online**. La página tiene dos tarjetas, **Subdominio Riqra** y **Dominio personalizado**.

## El subdominio Riqra

Al activar tu cuenta, la tienda recibe un subdominio derivado del nombre de tu organización. Si ese nombre ya estaba tomado, se agrega un número al final. La tarjeta muestra la dirección completa con un enlace para abrir la tienda y una etiqueta que indica si es el **Host principal** o si **Redirige a** tu dominio propio.

### Cambia el subdominio

<Steps>
  <Step title="Abre el editor">
    En la tarjeta **Subdominio Riqra**, haz clic en **Editar**.
  </Step>

  <Step title="Escribe el nuevo subdominio">
    Escribe solo la parte que va antes de `.tiendariqra.com`. Debajo del campo se muestra la dirección completa que quedará. El subdominio debe tener entre 3 y 63 caracteres en minúsculas, y solo puede usar letras, números y guiones. No puede empezar ni terminar con guion.
  </Step>

  <Step title="Guarda">
    Haz clic en **Guardar**. El cambio se aplica al instante. La dirección anterior deja de funcionar y no redirige a la nueva.
  </Step>
</Steps>

Algunos nombres están bloqueados. Los nombres reservados, como `admin`, `api`, `shop` o `checkout`, se rechazan con el mensaje **Ese subdominio está reservado**. Un subdominio que otra tienda ya usa se rechaza con **Ese subdominio ya está en uso**.

<Warning>
  Cuando cambias el subdominio, la dirección anterior queda en cuarentena por 7 días. Durante ese tiempo ninguna tienda puede tomarla, ni siquiera la tuya. Actualiza los enlaces que compartiste y avisa a tus clientes antes de cambiarlo.
</Warning>

## Conecta tu dominio propio

Puedes conectar un dominio raíz, como `acme.com`, o un subdominio de tu dominio, como `tienda.acme.com`. Cada tienda admite un dominio propio a la vez.

Si conectas un dominio raíz, la tienda se sirve en `www.acme.com` y `acme.com` redirige ahí. Escribir `acme.com` o `www.acme.com` da el mismo resultado. Si conectas un subdominio, la tienda se sirve en la dirección exacta que escribiste.

### Antes de empezar

* Necesitas acceso al panel DNS de tu dominio. Es el registrador donde lo compraste o el proveedor donde administras sus registros, como GoDaddy, Namecheap, Cloudflare o Punto.pe.
* Si esa dirección ya muestra otro sitio, dejará de mostrarlo cuando cambies los registros.

### Agrega el dominio

<Steps>
  <Step title="Abre el formulario">
    En la tarjeta **Dominio personalizado**, haz clic en **Agregar dominio personalizado**.
  </Step>

  <Step title="Escribe el dominio">
    Escribe el dominio sin `https://` ni rutas, por ejemplo `acme.com` o `tienda.acme.com`. Haz clic en **Agregar**.
  </Step>

  <Step title="Copia los registros DNS">
    La tarjeta muestra el dominio con el estado **Pendiente de DNS** y una tabla **Registros DNS requeridos** con el tipo, el nombre y el valor de cada registro. Cada fila tiene un botón para copiar el valor.
  </Step>

  <Step title="Crea los registros en tu proveedor DNS">
    Entra al panel DNS de tu dominio y crea cada registro tal como aparece en la tabla. Si ya existe un registro con el mismo tipo y nombre, reemplaza su valor en lugar de agregar otro.
  </Step>

  <Step title="Verifica">
    Vuelve al panel y haz clic en **Verificar**. Cada clic consulta tu DNS en ese momento. Si los registros todavía no se propagaron, el estado sigue en **Pendiente de DNS**. Espera unos minutos y vuelve a hacer clic en **Verificar**. Cuando el estado pase a **Activo**, la tienda ya responde en tu dominio con HTTPS.
  </Step>
</Steps>

### Qué registros vas a ver

| Dominio que escribiste      | Registros                                                              |
| --------------------------- | ---------------------------------------------------------------------- |
| `acme.com` o `www.acme.com` | Un registro `A` con nombre `@` y un registro `CNAME` con nombre `www`. |
| `tienda.acme.com`           | Un registro `CNAME` con nombre `tienda`.                               |

Copia los valores desde tu panel. A veces la tabla incluye también un registro `TXT`. Créalo igual que los demás.

Si tu proveedor no acepta `@` como nombre, usa el campo vacío o el dominio completo, según lo que pida su formulario.

<Note>
  Si usas Cloudflare, deja el proxy desactivado (nube gris) en estos registros hasta que el dominio esté **Activo**. Los cambios de DNS pueden tardar hasta 48 horas en propagarse, aunque en la mayoría de los proveedores tardan minutos.
</Note>

### Estados del dominio

| Estado                 | Qué significa                                                         | Qué hacer                                                                                                                       |
| ---------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Pendiente de DNS**   | Los registros aún no se detectan.                                     | Revisa que cada registro coincida con la tabla y haz clic en **Verificar**.                                                     |
| **Activo**             | El dominio responde con HTTPS y es la dirección oficial de la tienda. | Nada. La tabla de registros se oculta.                                                                                          |
| **Configuración rota** | El dominio estuvo activo y los registros dejaron de coincidir.        | Restaura los registros que muestra la tabla. Mientras tanto, el subdominio Riqra deja de redirigir y vuelve a servir la tienda. |

El estado solo cambia cuando agregas el dominio o haces clic en **Verificar**. Abrir la página no consulta tu DNS. Si la tabla de registros aparece vacía después de agregar el dominio, haz clic en **Verificar** para cargarla. Si cambias los registros DNS de un dominio activo, haz clic en **Verificar** para confirmar que sigue en **Activo**.

### Si el panel rechaza el dominio

* **Este dominio ya está conectado a otra tienda Riqra.** Otra organización ya lo usa. Escribe a soporte para resolverlo.
* **Esta tienda ya tiene un dominio personalizado.** Quita el actual antes de agregar otro.
* **No reconocemos ese dominio** u otro mensaje de validación. Revisa que sea un dominio público real. No se aceptan direcciones IP ni dominios de prueba.

## Cambia o quita el dominio

Para cambiar de dominio, quita el actual y agrega el nuevo. En la tarjeta **Dominio personalizado**, haz clic en **Quitar**. No pide confirmación.

El dominio deja de servir la tienda al instante y no redirige a ningún lado. El subdominio Riqra vuelve a ser la dirección oficial. Los registros DNS que creaste en tu proveedor no se borran, así que elimínalos si ya no los usas.

## Qué dirección usan tus clientes

Mientras tu dominio esté **Activo**, cualquier enlace al subdominio Riqra redirige a la misma página en tu dominio, así que los enlaces antiguos siguen funcionando. Los correos y enlaces de acceso que la plataforma envía a tus clientes usan la dirección oficial vigente en ese momento.