Ventas del checkout

Webhook de ventas: cualquier plataforma en TraceClose

Actualizado el

Crea la conexión Webhook de ventas (cualquier plataforma) en Configuración › Integraciones, genera el secreto y envía cada venta, en JSON, a la URL que muestra la conexión, con el secreto en el encabezado. Funciona con Zapier, Make, n8n o unas líneas de código en tu sistema.

Usa este camino cuando tu plataforma no está en la lista de integraciones listas para usar (Hotmart, Kiwify, Eduzz y Shopify): otro checkout, un sistema propio o una hoja de cálculo. Necesitas una herramienta de automatización que haga una llamada HTTP o a alguien que escriba unas líneas de código.

Paso a paso

  1. Crea la conexión

    En Configuración › Integraciones, haz clic en Nueva conexión y elige Webhook de ventas (cualquier plataforma). Es la misma conexión del lead del sitio: sirve para leads y ventas.

  2. Genera y guarda el secreto

    Haz clic en Generar secreto y en Copiar secreto. Guárdalo en la herramienta que va a hacer los envíos: después de guardar, no vuelve a aparecer.

  3. Copia la URL

    Abre la conexión: la pantalla muestra la URL del webhook, con el formato https://t.traceclose.com/webhooks/leads/site/<id-de-la-conexión>, y ejemplos listos para copiar.

  4. Arma el envío en tu herramienta

    Cuando la plataforma avise de una venta aprobada, haz un POST a la URL con el JSON de la venta (ejemplo abajo) y el encabezado Authorization: Bearer <secreto>.

  5. Prueba con una venta

    Envía una venta de prueba con tu correo y revisa el lead y la venta en el panel.

El JSON de la venta

POST https://t.traceclose.com/webhooks/leads/site/<id-de-la-conexión>
Content-Type: application/json
Authorization: Bearer <secreto>

{
  "version": 1,
  "event": "sale",
  "data": {
    "externalId": "pedido-5001",
    "email": "maria@ejemplo.com",
    "phone": "+5511999998888",
    "amountMinor": 49700,
    "currency": "USD",
    "occurredAt": "2026-10-12T10:15:00-03:00"
  }
}
  • externalId: el id del pedido en la plataforma. Si envías el mismo pedido otra vez, la venta no se duplica.
  • email o phone: al menos uno, para encontrar el lead. El teléfono va con el código de país (+55…) o en el formato del país de la operación.
  • amountMinor: el valor en centavos (en la unidad mínima de la moneda), sin comas ni puntos: US$ 497,00 se envía como 49700.
  • currency: la moneda del pedido (BRL, USD…).
  • Opcionales: occurredAt (cuándo se pagó, con zona horaria), leadExternalId (si ya enviaste el lead antes) y eventId (el id del Purchase del píxel, para que Meta no lo cuente dos veces).

Reembolso

Para cancelar una venta, envía el evento refund con el mismo externalId del pedido. Un reembolso repetido no da error.

{
  "version": 1,
  "event": "refund",
  "data": { "externalId": "pedido-5001" }
}

Origen del comprador (opcional)

Si la plataforma guarda las UTM o el fbclid, envía antes el evento lead con el campo attribution (utmSource, utmCampaign, utmContent, fbclid, fbc, fbp…). El formato completo está en leads del formulario de tu sitio.

Zapier, Make y n8n

  • Zapier: el disparador de tu plataforma (“nueva venta”) y la acción Webhooks by Zapier, evento POST (o Custom Request), con el cuerpo en JSON y el encabezado Authorization.
  • Make: el módulo de tu plataforma y el módulo HTTP › Make a request, método POST, cuerpo JSON y el encabezado.
  • n8n: el nodo de tu plataforma (o Webhook) y el nodo HTTP Request, método POST, cuerpo JSON y el encabezado.
  • Si la plataforma envía el valor con decimales (497.00), agrega un paso de fórmula en la herramienta para multiplicarlo por 100 y redondearlo antes de enviarlo.

Respuestas del webhook

  • 200: recibido (también cuando es repetido).
  • 401: secreto incorrecto, conexión desactivada o URL de otra conexión.
  • 400: cuerpo fuera del formato; la respuesta indica el campo.
  • Error 5xx o de red: vuelve a enviar. La misma venta no entra dos veces.

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…

  • 400 en todas las ventas: casi siempre el valor se envió con coma o punto, o faltaron el correo y el teléfono.
  • Perdiste el secreto: genera otro en Editar y cámbialo en la herramienta.
  • Venta sin origen en el informe: la plataforma no envió UTM; consulta parámetros de URL en los anuncios.

Preguntas frecuentes

¿Necesito saber programar?

No, si usas Zapier, Make o n8n: solo armas el envío con el JSON del ejemplo. Con código propio, son pocas líneas.

¿Puedo firmar el envío en lugar de enviar el secreto?

Sí: envía el encabezado x-traceclose-signature con sha256= y el HMAC-SHA256 del cuerpo, calculado con el secreto.

¿La venta se envía a Meta?

Sí, como Purchase con valor y moneda, si el envío de conversiones está activado y el lead está en una etapa ganada que tenga el Purchase.

Ve el camino del anuncio hasta la venta en tu WhatsApp.

Prueba TraceClose gratis por 7 días con tu equipo. Sin tarjeta para probar.

Probar 7 días gratisHacer una pregunta