> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compago.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Cómo personalizar el diseño de tu checkout
> Elige los colores, las esquinas, los datos de soporte y la dirección de tus links de pago.
export const SupportBox = () => ;
export const GuideImage = ({src, preview, alt, width, height, caption, variant = 'screen'}) => {
const [open, setOpen] = useState(false);
const [view, setView] = useState(null);
const opener = useRef(null);
const dialog = useRef(null);
const viewport = useRef(null);
const closeButton = useRef(null);
const fitScale = useRef(1);
const drag = useRef(null);
const long = height / width > 1.6;
const icon = (d, size = 18) => ;
const ZOOM_IN = 'M11 3a8 8 0 1 0 0 16 8 8 0 0 0 0-16zM21 21l-4.35-4.35M11 8v6M8 11h6';
const ZOOM_OUT = 'M11 3a8 8 0 1 0 0 16 8 8 0 0 0 0-16zM21 21l-4.35-4.35M8 11h6';
const FIT = 'M3 7V5a2 2 0 0 1 2-2h2M17 3h2a2 2 0 0 1 2 2v2M21 17v2a2 2 0 0 1-2 2h-2M7 21H5a2 2 0 0 1-2-2v-2';
const DOWNLOAD = 'M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4M7 10l5 5 5-5M12 15V3';
const CLOSE = 'M18 6 6 18M6 6l12 12';
const clampView = next => {
const el = viewport.current;
if (!el) return next;
const w = width * next.scale;
const h = height * next.scale;
const keep = 96;
const x = w <= el.clientWidth ? (el.clientWidth - w) / 2 : Math.min(keep, Math.max(el.clientWidth - w - keep, next.x));
const y = h <= el.clientHeight ? (el.clientHeight - h) / 2 : Math.min(keep, Math.max(el.clientHeight - h - keep, next.y));
return {
scale: next.scale,
x,
y
};
};
const fit = () => {
const el = viewport.current;
if (!el) return;
const scale = long ? Math.min(1, el.clientWidth * 0.94 / width) : Math.min(1, el.clientWidth * 0.94 / width, el.clientHeight * 0.88 / height);
fitScale.current = scale;
setView(clampView({
scale,
x: (el.clientWidth - width * scale) / 2,
y: long ? 72 : (el.clientHeight - height * scale) / 2
}));
};
const zoomAt = (factor, cx, cy) => {
setView(current => {
const el = viewport.current;
if (!current || !el) return current;
const px = cx ?? el.clientWidth / 2;
const py = cy ?? el.clientHeight / 2;
const scale = Math.min(Math.max(fitScale.current * 0.5, current.scale * factor), Math.max(1.5, fitScale.current * 6));
const ratio = scale / current.scale;
return clampView({
scale,
x: px - (px - current.x) * ratio,
y: py - (py - current.y) * ratio
});
});
};
const panBy = (dx, dy) => setView(current => current && clampView({
...current,
x: current.x + dx,
y: current.y + dy
}));
const close = () => {
setOpen(false);
setView(null);
opener.current?.focus();
};
const show = event => {
opener.current = event.currentTarget;
setOpen(true);
};
const actions = useRef({});
actions.current = {
fit,
zoomAt,
panBy,
close
};
useEffect(() => {
const modal = dialog.current;
if (!open || !modal) return undefined;
if (!modal.open) modal.showModal();
const el = viewport.current;
actions.current.fit();
closeButton.current?.focus();
const onResize = () => actions.current.fit();
const onKey = event => {
const {zoomAt: zoom, panBy: pan} = actions.current;
if (event.key === '+' || event.key === '=') zoom(1.25); else if (event.key === '-' || event.key === '_') zoom(0.8); else if (event.key === '0') actions.current.fit(); else if (event.key === 'ArrowUp') pan(0, 120); else if (event.key === 'ArrowDown') pan(0, -120); else if (event.key === 'ArrowLeft') pan(120, 0); else if (event.key === 'ArrowRight') pan(-120, 0); else return;
event.preventDefault();
};
const onWheel = event => {
event.preventDefault();
const rect = el.getBoundingClientRect();
if (event.ctrlKey || event.metaKey) actions.current.zoomAt(Math.exp(-event.deltaY * 0.0022), event.clientX - rect.left, event.clientY - rect.top); else actions.current.panBy(-event.deltaX, -event.deltaY);
};
const root = document.documentElement;
const overflow = root.style.overflow;
root.style.overflow = 'hidden';
window.addEventListener('resize', onResize);
document.addEventListener('keydown', onKey);
el?.addEventListener('wheel', onWheel, {
passive: false
});
return () => {
root.style.overflow = overflow;
window.removeEventListener('resize', onResize);
document.removeEventListener('keydown', onKey);
el?.removeEventListener('wheel', onWheel);
if (modal.open) modal.close();
};
}, [open]);
const onPointerDown = event => {
if (event.button !== 0) return;
drag.current = {
x: event.clientX,
y: event.clientY,
travel: 0
};
event.currentTarget.setPointerCapture(event.pointerId);
};
const onPointerMove = event => {
const start = drag.current;
if (!start) return;
const dx = event.clientX - start.x;
const dy = event.clientY - start.y;
start.travel += Math.abs(dx) + Math.abs(dy);
start.x = event.clientX;
start.y = event.clientY;
panBy(dx, dy);
};
const onPointerUp = event => {
const start = drag.current;
drag.current = null;
if (!start || start.travel > 6 || !view) return;
const rect = viewport.current.getBoundingClientRect();
const x = event.clientX - rect.left;
const y = event.clientY - rect.top;
const inside = x >= view.x && x <= view.x + width * view.scale && y >= view.y && y <= view.y + height * view.scale;
if (!inside) close();
};
const onDoubleClick = event => {
const rect = viewport.current.getBoundingClientRect();
if (view && view.scale > fitScale.current * 1.4) fit(); else zoomAt(2.2, event.clientX - rect.left, event.clientY - rect.top);
};
const percent = view ? Math.round(view.scale / fitScale.current * 100) : 100;
const viewer = open && ;
if (variant === 'guide') {
return
{caption && {caption}}
{viewer}
;
}
return
{caption && {caption}}
{viewer}
;
};
export const GuideVideo = ({src, poster, title, duration, caption}) => {
const dialog = useRef(null);
const player = useRef(null);
const opener = useRef(null);
const resumeAt = useRef(0);
const pageOverflow = useRef('');
const icon = (d, size = 18, fill = false) => ;
const PLAY = 'M9 6.5 18.5 12 9 17.5z';
const MAXIMIZE = 'M8 3H5a2 2 0 0 0-2 2v3M21 8V5a2 2 0 0 0-2-2h-3M3 16v3a2 2 0 0 0 2 2h3M16 21h3a2 2 0 0 0 2-2v-3';
const CLOSE = 'M18 6 6 18M6 6l12 12';
const open = event => {
const modal = dialog.current;
const video = player.current;
if (!modal || !video || modal.open) return;
opener.current = event.currentTarget;
pageOverflow.current = document.documentElement.style.overflow;
document.documentElement.style.overflow = 'hidden';
modal.showModal();
video.currentTime = resumeAt.current;
video.play().catch(() => {});
video.focus();
};
const onClose = () => {
const video = player.current;
if (video) {
resumeAt.current = video.ended ? 0 : video.currentTime;
video.pause();
}
document.documentElement.style.overflow = pageOverflow.current;
opener.current?.focus();
};
const close = () => {
if (dialog.current?.open) dialog.current.close();
};
const fullscreen = () => {
const video = player.current;
if (!video) return;
video.play().catch(() => {});
if (video.requestFullscreen) video.requestFullscreen().catch(() => {}); else if (video.webkitEnterFullscreen) video.webkitEnterFullscreen();
};
return
{caption && {caption}}
;
};
El diseño del checkout es cómo ven tus clientes la pantalla donde te pagan: sus colores, sus esquinas y tus datos de soporte. Cámbialo para que tus links de pago se vean como tu negocio.
## Dónde está en la app
* En el menú de la izquierda, abre **Configuraciones** y entra a **Organización**.
* Arriba, haz clic en la pestaña **Diseño**.
## Antes de empezar
* Solo el **Dueño** y los **Administradores** pueden cambiar el diseño.
* Ten a la mano los colores de tu marca en código hexadecimal (por ejemplo, **#0F3D2E**), si quieres usar los tuyos.
## Paso a paso
En el menú de la izquierda, abre **Configuraciones** › **Organización**. Arriba, haz clic en la pestaña **Diseño**.
Solo el **Dueño** y los **Administradores** pueden cambiar el diseño.
En **Colores** eliges el **Panel**, el **Acento** y el **Botón de pago**. Haz clic en una muestra o escribe el código de tu color.
A la derecha, la vista previa cambia al momento. Si el texto del botón no se lee bien, te avisamos.
En **Esquinas** eliges qué tan redondeados se ven la tarjeta, los campos y el botón: **Rectas**, **Suaves** o **Redondas**.
Más abajo, en **Soporte**, agregas tu **WhatsApp de soporte** y tu **Correo de soporte** para que tus clientes te encuentren.
Revisa cómo se ve en la vista previa. Luego haz clic en **Guardar cambios**, en la barra de abajo.
¿No te convenció? Con **Descartar cambios** regresas al diseño que tenías.
Tu diseño ya está guardado. La vista previa muestra cómo verán tus clientes la **Pantalla de pago** y la **Confirmación**.
Para volver a los colores de fábrica, haz clic en **Restablecer diseño**, arriba a la derecha.
## Qué pasa después
* Ves el aviso **Diseño actualizado**. Todos tus links de pago usan el diseño nuevo desde ese momento.
* Si agregaste datos de soporte y dejaste encendido **Mostrar los datos de contacto**, tus clientes los ven al final del checkout.
* En el editor de links de pago, **Diseño del checkout** y **Soporte** muestran lo que configuraste aquí.
* El cambio queda registrado en [Actividad](/manual/organizacion/actividad-de-tu-equipo).
## Preguntas frecuentes
No. El diseño es uno para toda tu organización y lo usan todos tus links de pago.
En la misma pestaña, en **Dirección de tus links de pago**, escribe el nombre que quieres después de **/p/** y haz clic en **Guardar cambios**. Usa entre 3 y 30 caracteres: minúsculas, números y guiones. Los links con la dirección anterior siguen funcionando.
En **Soporte**, apaga **Mostrar los datos de contacto** y guarda. Tus clientes solo verán el nombre de tu negocio.
Haz clic en **Restablecer diseño**, arriba a la derecha, y confirma con **Restablecer**. Tus links vuelven a los colores predeterminados y dejan de mostrar tus datos de soporte.
## Errores comunes
### El texto del botón no alcanza 4.5:1 sobre el color elegido.
El color del **Botón de pago** es tan claro o tan parecido al texto que costará leer **Pagar**. Puedes guardarlo así, pero te recomendamos un color más oscuro o más intenso.
### Ese nombre ya está en uso.
Otro negocio ya usa esa dirección para sus links. Prueba con otra, por ejemplo agregando tu ciudad.
### Solo minúsculas, números y guiones intermedios.
La dirección de tus links no acepta mayúsculas, acentos, espacios ni otros signos. Escríbela como **ferreteria-el-tornillo**.
### Teléfono demasiado largo
El **WhatsApp de soporte** puede tener hasta 32 caracteres. Escríbelo con lada y sin texto extra, por ejemplo **+52 55 5555 0142**.
## Guía en una imagen
Todos los pasos en una sola imagen, para tenerla a mano o compartirla con tu equipo.
## Guías relacionadas
Cobra un monto fijo con un link que compartes por WhatsApp, correo o redes.
El checkout paso a paso, desde que abre el link hasta que paga.
Tu logo, nombre, referencia bancaria, RFC y domicilio.
Quién cambió qué y cuándo en tu panel.
## ¿Necesitas ayuda?