> ## 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 guardar la tarjeta de un cliente
> Envía un link para que tu cliente registre su tarjeta y puedas cobrarle después sin pedírsela otra vez.
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}}
;
};
Con **Tarjetas en archivo** guardas la tarjeta de un cliente para cobrarle cuando lo necesites, sin pedirle otra vez sus datos: por ejemplo, a un contratista que te compra material cada semana. Tú creas un link, se lo mandas y tu cliente registra su tarjeta en él.
## Dónde está en la app
* En el menú de la izquierda, abre **Avanzado** y entra a **Tarjetas en archivo**.
* Arriba a la derecha, haz clic en **Crear método de pago**. Se abre una ventana para elegir el tipo de link y escribir los datos de tu cliente.
## Antes de empezar
* Pueden crear el link el **Dueño** y el **Administrador** de un comercio. El **Miembro** puede ver las tarjetas guardadas, pero no crear links ni cobrarles.
* Ten a la mano el nombre, el apellido, el correo y el teléfono de tu cliente.
* Tu cliente puede guardar una tarjeta Visa o Mastercard.
## Paso a paso
En el menú de la izquierda, abre **Avanzado** y haz clic en **Tarjetas en archivo**.
¿Tu menú solo muestra íconos? **Avanzado** es el del rayo.
Aquí ves las tarjetas que tus clientes ya guardaron. Haz clic en **Crear método de pago**, arriba a la derecha.
Para encontrar una tarjeta, búscala por ID externo, últimos 4 dígitos, nombre o email del cliente.
Deja **Solo guardar la tarjeta**. Escribe el nombre, el apellido, el correo y el teléfono de tu cliente.
¿Quieres cobrarle o apartarle un monto en el mismo link? Elige **Cobrar y guardar la tarjeta** o **Retener y guardar la tarjeta** y escribe el monto.
Revisa los datos y haz clic en **Crear método de pago**.
En **Configuración del link** eliges cuánto tiempo sirve el link: 24 horas, 48 horas, 7 días o 30 días. Si no cambias nada, sirve 48 horas.
Tu link está listo. Cópialo con el botón de copiar y envíaselo a tu cliente por WhatsApp o correo. Luego haz clic en **Ir al detalle**.
Cuando tu cliente guarde su tarjeta, el link deja de funcionar. Si no la guarda a tiempo, el link vence.
El método de pago queda **Pendiente** hasta que tu cliente guarde su tarjeta. Si necesitas el link otra vez, cópialo aquí, en **Tarjeta**.
También puedes copiarlo desde el menú de tres puntos, arriba a la derecha, con **Copiar link de checkout**.
## Qué pasa después
* Tu cliente abre el link, escribe los datos de su tarjeta y la guarda. Te lo mostramos en [Cómo guarda tu cliente su tarjeta](/manual/tu-cliente/guardar-su-tarjeta).
* Con **Solo guardar la tarjeta** se hace un cargo de verificación, de \$1.00 si no lo cambiaste, que se reembolsa automáticamente.
* En cuanto tu cliente guarda su tarjeta, el método de pago pasa a **Activo** y ves la marca y los últimos 4 dígitos de la tarjeta.
* Desde ese momento puedes [cobrarle](/manual/avanzado/cobrar-a-una-tarjeta-guardada) o [retener fondos](/manual/avanzado/retener-capturar-o-liberar) en su tarjeta cuando lo necesites.
## Preguntas frecuentes
No. Tú copias el link y se lo envías por WhatsApp, correo o como prefieras. Si lo necesitas otra vez, está en el detalle del método de pago mientras siga **Pendiente**.
48 horas, si no cambias nada. En **Configuración del link** › **Vigencia del link** puedes elegir 24 horas, 48 horas, 7 días o 30 días. En el detalle del método de pago ves la fecha en **Expira**. Si vence antes de que tu cliente guarde su tarjeta, crea un link nuevo.
Es un cargo pequeño que confirma que la tarjeta es válida y se reembolsa automáticamente a tu cliente. Es de \$1.00 si no lo cambias; puedes ajustarlo en **Configuración del link** › **Monto de verificación**. En el **Historial de cobros** de la tarjeta aparece como **Reembolsado**.
Sí. Elige **Cobrar y guardar la tarjeta** para que pague el monto al guardar su tarjeta, o **Retener y guardar la tarjeta** para bloquear el monto sin cobrarlo. Una retención la capturas o la liberas en un plazo de 7 días naturales. Te lo explicamos en [Retener fondos](/manual/avanzado/retener-capturar-o-liberar).
Visa y Mastercard. Si intenta con otra, verá el aviso «Tarjeta no soportada» y podrá intentar con otra tarjeta.
## Errores comunes
### No veo «Avanzado» ni «Tarjetas en archivo» en el menú
Tarjetas en archivo es parte de las cuentas de comercio. Si tu cuenta es de fabricante, no tienes esta sección. Si eres comercio y no la ves, escríbenos.
### Aparece «El nombre es requerido» o «Correo inválido»
Falta un dato de tu cliente o el correo no es válido. **Nombre**, **Apellido**, **Correo electrónico** y **Teléfono** son obligatorios: revisa el campo marcado y vuelve a hacer clic en **Crear método de pago**.
### Soy Miembro y no puedo crear el link
Crear links para guardar tarjetas es solo para el **Dueño** y el **Administrador**. Pídele a uno de ellos que lo cree por ti.
### Mi cliente dice que el link ya no funciona
El link deja de funcionar cuando vence o cuando tu cliente ya guardó su tarjeta. Búscalo en **Tarjetas en archivo**: si dice **Activo**, la tarjeta ya quedó guardada; si sigue **Pendiente** y ya pasó la fecha de **Expira**, crea un link nuevo.
## 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 sin pedirle otra vez la tarjeta a tu cliente.
Aparta un monto en la tarjeta y cóbralo después.
Lo que ve tu cliente al registrar su tarjeta.
Quita una tarjeta para que ya no se le pueda cobrar.
## ¿Necesitas ayuda?