Ventas del checkout

Cómo conectar Kiwify a TraceClose

Actualizado el 12 de octubre de 2026

Paso a paso

1. Crea la conexión en TraceClose

   En Configuración › Integraciones, haz clic en Nueva conexión y, en el grupo Ventas del checkout, elige Kiwify. Deja la pestaña abierta: la pantalla muestra la URL del webhook (con botón para copiar) y el campo Token.

2. Crea el webhook en Kiwify

   En el panel de Kiwify, abre Apps › Webhooks y haz clic en Crear webhook. Ponle un nombre (por ejemplo, “TraceClose”), pega la URL del webhook de TraceClose y elige todos los productos o uno solo.

3. Marca los eventos

   Marca Compra aprobada, Compra reembolsada, Chargeback y, si vendes suscripciones, Suscripción renovada.

4. Copia el token

   El formulario del webhook muestra un token. Cópialo y pégalo en el campo Token de TraceClose. Guarda el webhook en Kiwify.

5. Elige las opciones y guarda

   Decide el envío del Purchase a Meta (activado por defecto; si el píxel del checkout ya envía la compra, mira más abajo) y si el checkout no pagado se convierte en lead (desactivado por defecto). Haz clic en Guardar.

6. Prueba

   En Kiwify, usa Probar webhook. El evento aparece en la conexión de TraceClose como último evento recibido.

Cuál es la URL

El panel muestra la URL lista para copiar, con el formato https://t.traceclose.com/webhooks/sales/kiwify/<id-de-la-conexión>. Sirve solo para esa conexión.

Carrito abandonado, boleto y pix generados (opcional)

Activa checkout no pagado se convierte en lead en la conexión y marca, en Kiwify, Carrito abandonado, Boleto generado y Pix generado. El lead entra con su origen, sin venta y sin Purchase, para que el vendedor le escriba por WhatsApp. Si paga después, la venta entra en el mismo lead.

Qué pasa en TraceClose

• Cada venta aprobada se convierte en una venta en TraceClose, con el valor pagado y la moneda del pedido, acreditada al vendedor del lead. El lead pasa a la etapa ganada.
• TraceClose busca el lead por la referencia del enlace de checkout, después por el teléfono y después por el correo. Si no lo encuentra, crea el lead con el origen que guardó el checkout y lo asigna por la rotación.
• Un lead que ya existía conserva su origen y su vendedor: si llegó por un anuncio de clic a WhatsApp, sigue acreditado a ese anuncio.
• Un reembolso o un contracargo cancela la venta. Si la plataforma reenvía la misma entrega, nada se duplica.

Para que la venta se asocie al lead correcto aunque el comprador pague con otro correo u otro teléfono, usa Copiar enlace de checkout en el detalle del lead: pega la URL del producto y TraceClose agrega la referencia del lead en el parámetro de seguimiento de la plataforma. En Kiwify, la referencia va en el parámetro sck. Las UTM que llegan al checkout (utm_source, utm_campaign…) también sirven como origen del lead nuevo.

Si el píxel de Meta ya está instalado en el checkout de la plataforma y envía el Purchase, elige quién envía la compra: desactiva el envío del Purchase en esta conexión con un clic (o desactiva el Purchase en el píxel del checkout). Así Meta recibe la venta una sola vez, y la venta sigue entrando en el panel y en el ROAS.

¿No funcionó? Revisa…

• No llega nada: revisa la URL y que el webhook esté activo para el producto vendido. En Kiwify, el menú de tres puntos del webhook muestra los registros de envío y permite reenviar.
• Error de autenticación en la conexión: el token de TraceClose no coincide con el token del webhook en Kiwify. Cópialo de nuevo y guárdalo en Editar.
• La venta llegó, pero no se envió a Meta: consulta la venta no aparece en Meta.

Preguntas frecuentes