Parámetros de URL del checkout

Esta es la referencia para quien genera enlaces de checkout en el código, por ejemplo en una página de ventas, en un correo transaccional o en un CRM. Lo que hace cada parámetro para el comprador, con ejemplos para el dueño de la tienda, está en Enlace de pago y parámetros de URL.

La dirección baseCopiar enlace de la sección

https://pay.vipter.com/<slug-o-id-de-la-oferta>

Cuando el enlace no puede abrirse, el checkout redirige a /unavailable?reason=<motivo>. El motivo queda en la dirección para diagnóstico:

ParámetrosCopiar enlace de la sección

Todos son opcionales y el orden no importa. Un parámetro repetido vale por el primer valor. Los parámetros desconocidos se ignoran.

Reservados: rec es el token del enlace de recuperación de checkout abandonado, que viene listo en el recovery_url del evento checkout.abandoned. ctx es de uso interno de Vipter. No armes enlaces con ellos.

El checkout no acepta teléfono, documento ni dirección por URL.

Reglas de cada parámetroCopiar enlace de la sección

packCopiar enlace de la sección

Solo las ofertas de pago único tienen paquetes. En una oferta de suscripción, cualquier pack lleva a la página de enlace no disponible. Sin el parámetro, el enlace vende 1 unidad al precio de la oferta. El checkout no tiene selector de paquete: un enlace por paquete.

langCopiar enlace de la sección

El idioma del enlace prevalece sobre la regla de la tienda que vende a un solo país, que oculta el selector y usa el idioma de ese país. El checkout guarda la elección en la cookie pay_locale durante un año, y las visitas siguientes sin lang usan esa cookie. En una tienda de un solo país, la cookie no se usa: solo el lang del propio enlace cambia el idioma.

Origen de la campaña: UTMs, src y sckCopiar enlace de la sección

Valen como primer toque: el primer enlace que trajo utm_*, src o sck a ese navegador en los últimos 30 días define todos esos valores juntos. Un enlace posterior con otra campaña no cambia ninguno de ellos. El checkout guarda estos datos en el localStorage del dominio del checkout, en la clave vpt_attr, y el plazo de 30 días cuenta desde la primera vez que se guardó algo.

IDs de clic, cookies y vCopiar enlace de la sección

Valen por el último valor recibido: un clic nuevo en un anuncio cambia el gclid guardado, y el último enlace de vendedor abierto define el v. Cuando llega un fbclid sin fbc, el checkout arma el fbc en el formato fb.1.<milisegundos>.<fbclid>. El código v se comprueba cuando el checkout crea la sesión de pago: vale el vendedor activo en ese momento.

email y nameCopiar enlace de la sección

La dirección de entrada que Vipter guarda con la venta se guarda sin email, name, phone, rec y ctx. Aun así, estos datos quedan en el historial del navegador y en los logs de quien sirve la página anterior. Usa email y name solo en enlaces individuales, como en un correo para un cliente, nunca en anuncios ni en páginas públicas.

Adónde van los datosCopiar enlace de la sección

• El vendedor (v) queda en el pedido y entra en las comisiones.
• Las UTMs, src, sck y los IDs de clic quedan en la venta, alimentan el origen de las ventas y el envío de conversiones a las plataformas de anuncios.
• Las UTMs van en el campo utm del evento checkout.abandoned. Los eventos de pedido no traen UTMs ni vendedor.

Armar enlaces en el códigoCopiar enlace de la sección

Codifica cada valor. Un + sin codificar, común en correos como ana+loja@example.com, se convierte en espacio. Usa las funciones del lenguaje en lugar de concatenar texto:

function checkoutLink(base, params) {
  const url = new URL(base);
  for (const [key, value] of Object.entries(params)) {
    if (value !== undefined && value !== null && value !== '') url.searchParams.set(key, String(value));
  }
  return url.toString();
}

checkoutLink('https://pay.vipter.com/kit-cha', { pack: 3, code: 'BLACK10', v: 'ana', utm_source: 'instagram', utm_campaign: 'black-friday' });
// https://pay.vipter.com/kit-cha?pack=3&code=BLACK10&v=ana&utm_source=instagram&utm_campaign=black-friday

checkoutLink('https://pay.vipter.com/curso-fotografia', { email: 'ana+teste@example.com', name: 'Ana Souza', lang: 'pt' });
// https://pay.vipter.com/curso-fotografia?email=ana%2Bteste%40example.com&name=Ana+Souza&lang=pt

En Python, urllib.parse.urlencode genera la misma query:

from urllib.parse import urlencode

"https://pay.vipter.com/curso-fotografia?" + urlencode({"email": "ana+teste@example.com", "name": "Ana Souza", "lang": "pt"})
# https://pay.vipter.com/curso-fotografia?email=ana%2Bteste%40example.com&name=Ana+Souza&lang=pt

+ y %20 valen como espacio en el checkout. Si tu página de ventas ya tiene UTMs en la dirección, el script t.js lleva esos valores hasta el enlace sin código.

Qué hacer despuésCopiar enlace de la sección

• Consulta cómo ve el comprador el checkout.
• Lleva las UTMs de la página de ventas hasta el checkout con el script t.js.