---
title: Dominio personalizado
slug: dominio-personalizado
docTags: 
createdAt: 2026-01-25T21:00:39.396Z
---

###

Este documento describe los pasos técnicos que debe seguir el equipo de infraestructura o DNS del cliente para la correcta configuración de los CNAME requeridos por SUGA.


Los registros CNAME permiten direccionar los dominios del cliente hacia las plataformas de SUGA para la gestión de **pantallas de pago, APIs y portales de administración** de comercios.

##

## Configuración de CNAME principales

### Portal del comercio (Consola)

Los dominios que el cliente utilizará para las **pantallas de pago** y el **acceso al BackOffice** de subcomercios deberán apuntar al siguiente registro CNAME:

cname.sugaway.com **Ejemplo:**

| Subdominio del cliente | Tipo  | Valor destino       |
| ---------------------- | ----- | ------------------- |
| *pagos.midominio.com*  | CNAME | *cname.sugaway.com* |

### APIs para Subcomercios

Del mismo modo, las APIs que serán utilizadas por los subcomercios deberán configurarse apuntando al mismo registro CNAME:

cname.sugaway.com**Ejemplo:**

| Subdominio del cliente | Tipo  | Valor destino       |
| ---------------------- | ----- | ------------------- |
| a*pi.midominio.com*    | CNAME | *cname.sugaway.com* |

### Configuración de CNAME para Portal de Desarrolladores

Para habilitar un **portal de desarrolladores** destinado a los subcomercios, el dominio deberá apuntar al siguiente CNAME:

cname-docs.sugaway.com**Ejemplo:**

| Subdominio del cliente | Tipo  | Valor destino            |
| ---------------------- | ----- | ------------------------ |
| dev.plataforma.com     | CNAME | *cname-docs.sugaway.com* |

### Recomendaciones técnicas

- Los registros deben crearse en el **DNS público del dominio del cliente**.
- El tiempo de propagación dependerá del TTL configurado (recomendado: **3600 segundos**).
- No deben utilizarse registros A ni redirecciones HTTP/HTTPS en lugar de los CNAME.
- En caso de usar **Cloudflare u otro proxy DNS**, asegurarse de que el registro esté en modo **DNS Only**  y no proxificado .
- Se recomienda validar la propagación mediante herramientas como *https\://dnschecker.org* .

### Validación final

Una vez completada la configuración, el cliente deberá informar a su **Project Manager o contacto técnico de SUGA** los dominios configurados para su verificación.


SUGA confirmará el correcto enrutamiento y procederá con la vinculación de los entornos.