Saltar al contenido principal

Ata las ventas de Lemon Squeezy al canal que las generó.

Vero verifica cada webhook de Lemon Squeezy y registra el pedido con la visita que lo trajo: el tracker añade la sesión a tus enlaces de checkout.

Cómo se conecta

La visita viaja con el pago.

La sesión de la visita viaja con el pago y vuelve en el webhook firmado.

  1. 1La visita

    El tracker da a cada visita un id de sesión, sin cookies.

    window.vero.session()
  2. 2El checkout de Lemon Squeezy

    El módulo checkout añade la sesión al enlace de checkout en el clic.

    checkout[custom][vero]
  3. 3El webhook firmado

    Lemon Squeezy envía la venta a Vero, firmada con el secreto de tu sitio.

    x-signature
  4. 4Los ingresos por fuente

    Vero une la venta a su visita: fuente, campaña, referrer, canal y página de entrada, sin impuestos y descontados los reembolsos.

    POST /api/revenue/lemonsqueezy?s=SITE_TOKEN
Cómo se configura

Tres pasos, sin código.

  1. 1Añade un webhook de Lemon Squeezy apuntando a Vero con order_created, order_refunded, subscription_payment_success y subscription_payment_refunded; la firma se verifica en cada evento.
  2. 2Activa el módulo checkout del tracker: un clic en un enlace de checkout añade checkout[custom][vero] con la sesión, y Vero la lee de los datos personalizados del webhook.
  3. 3Los pedidos y las renovaciones se guardan sin impuestos, y una renovación conserva la fuente del primer pago atribuido del cliente. Los ingresos se agregan por fuente, campaña, referrer, canal y página de entrada.
URL para Lemon Squeezy
https://[tu-endpoint-vero]/api/revenue/lemonsqueezy?s=YOUR_SITE_TOKEN
Eventos de Lemon Squeezy
order_created
order_refunded
subscription_payment_success
subscription_payment_refunded

Qué obtienes

  • Verificación de firma HMAC en cada webhook
  • Pedidos, renovaciones y reembolsos registrados, duplicados ignorados
  • Atribución por fuente desde el propio enlace de checkout
  • Sin cookies, sin IP almacenada
Ciclo de vida

Una venta, del primer pago a la disputa.

  1. 1La primera venta

    En la demo pública, que es ficticia, una visita desde news.ycombinator.com termina en una compra de 99 €. El clic en el enlace de checkout lleva la visita, order_created la devuelve en meta.custom_data.vero y Vero guarda el pedido sin impuestos bajo esa fuente. En una suscripción, este pedido es el primer pago: el subscription_payment_success con billing_reason initial se salta, así que cuenta una vez.

  2. 2Una renovación

    Si ese cliente renueva, llega subscription_payment_success. Cuando no trae visita, Vero busca el id de cliente de Lemon Squeezy y acredita la renovación a la fuente de su primer pago atribuido.

  3. 3Un reembolso

    Si a ese cliente se le reembolsa, llega order_refunded o subscription_payment_refunded. Lemon Squeezy da el importe reembolsado como un acumulado, así que Vero resta solo lo nuevo. Sale de la fuente de la venta, sin impuestos y en la misma proporción que la venta.

  4. 4Una disputa

    Vero solo resta reembolsos. Una disputa o un contracargo no se descuentan, así que el pedido disputado sigue en los ingresos de su fuente. Cada evento cuenta una vez, y si Vero falla al procesar uno responde con un 5xx para que Lemon Squeezy lo reintente y la venta no se pierda.

Ayuda

Si los números no cuadran.

La tarjeta dice «Último intento rechazado: firma no válida»

Lemon Squeezy firma cada webhook en X-Signature, un HMAC-SHA256 del cuerpo en bruto hecho con el secreto de firma del webhook. Vero lo comprueba con el secreto guardado en Vero, así que los dos tienen que ser la misma cadena. Vuelve a poner el secreto en el webhook, pega el mismo valor en Vero y lanza un pedido de prueba.

Un pedido suma al total pero no tiene fuente

El pedido volvió sin meta.custom_data.vero. El módulo checkout añade checkout[custom][vero] cuando el visitante hace clic en un enlace de checkout, así que un checkout abierto por otro camino, o con el módulo apagado, no lleva visita. El pedido cuenta igual, y hereda la fuente de un pago anterior atribuido del cliente si lo hay.

Un pedido de prueba no suma ingresos

Un pedido con test_mode se acepta con un 200 y no se cuenta, y la tarjeta muestra «Último intento ignorado: modo de prueba». Eso demuestra que la URL y el secreto funcionan. Si no aparece nada, revisa la URL: un token del sitio erróneo tras ?s= recibe un 404, y si falta, un 400.

¿Cómo se verifica el webhook?

Vero verifica la firma HMAC de Lemon Squeezy con un secreto por sitio, guardado cifrado, y rechaza eventos sin firma o que no coinciden.

¿Qué eventos de Lemon Squeezy acepta Vero?

order_created, order_refunded, subscription_payment_success y subscription_payment_refunded. El primer pago de una suscripción cuenta una vez, desde su pedido. Cualquier otro evento se ignora.

¿Hay cookies?

Ninguna. La sesión viaja en el enlace de checkout y vuelve en el webhook firmado.

Atribuye tus ingresos de Lemon Squeezy

Al apuntarte aceptas recibir avisos del lanzamiento y nuestra Política de Privacidad.

Ver la demo