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.
La visita viaja con el pago.
La sesión de la visita viaja con el pago y vuelve en el webhook firmado.
- 1La visita
El tracker da a cada visita un id de sesión, sin cookies.
window.vero.session() - 2El checkout de Lemon Squeezy
El módulo checkout añade la sesión al enlace de checkout en el clic.
checkout[custom][vero] - 3El webhook firmado
Lemon Squeezy envía la venta a Vero, firmada con el secreto de tu sitio.
x-signature - 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
Tres pasos, sin código.
- 1Añade un webhook de Lemon Squeezy apuntando a Vero con
order_created,order_refunded,subscription_payment_successysubscription_payment_refunded; la firma se verifica en cada evento. - 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.
- 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.
https://[tu-endpoint-vero]/api/revenue/lemonsqueezy?s=YOUR_SITE_TOKEN
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
Una venta, del primer pago a la disputa.
- 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.
- 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.
- 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.
- 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.
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.
Sigue leyendo
- Webhooks de ingresosEventos, firmas, reembolsos y modo de prueba, proveedor por proveedor.
- Instala el trackerLa atribución empieza en la visita: una etiqueta en tu sitio, sin cookies.
- Conecta tu proveedor de pagos y pasa el id de visitaPega una URL de webhook en Stripe, Lemon Squeezy o Paddle y pasa el id de visita en el checkout. Cada venta llega con su fuente.
- Cómo atribuir ingresos sin cookiesLa atribución no necesita un identificador persistente. Necesita conectar un pago con la visita que lo provocó, y eso se hace en el servidor, en el momento del pago.
- Pon un script. Ve qué genera dinero.Analítica sin cookies para indie hackers: atribución de ingresos, un script desde 1,2 KB, servidor MCP para Claude y Cursor, y un plan Hobby de 0 €.