Atribuye los ingresos de Stripe a su fuente real.
Pega una URL de webhook en Stripe. A partir de ahí, cada pago llega a Vero con la visita que lo produjo. Lees los ingresos por fuente, campaña, referrer, canal y página de entrada, sin una sola cookie.
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 Stripe
El módulo checkout añade la sesión al Payment Link en el clic.
client_reference_id - 3El webhook firmado
Stripe envía la venta a Vero, firmada con el secreto de tu sitio.
stripe-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/stripe/SITE_TOKEN
Cuatro pasos, sin código.
- 1En Vero, copia la URL del webhook de Stripe en la pantalla Conecta tus ventas.
- 2En Stripe, añádela como destino de webhook en la última versión de la API. Elige los cuatro eventos y pega su secreto de firma (
whsec_…) en Vero. - 3Activa el módulo checkout del tracker. Desde entonces, un clic en un Payment Link lleva la sesión como
client_reference_id. - 4Los ingresos se agregan por fuente, campaña, referrer, canal y página de entrada en tu dashboard. Las renovaciones y los reembolsos también cuentan.
https://[tu-endpoint-vero]/api/revenue/stripe/YOUR_SITE_TOKEN
checkout.session.completed checkout.session.async_payment_succeeded invoice.paid charge.refunded
Qué obtienes
- Ingresos por canal, sin impuestos y descontados los reembolsos
- Las renovaciones conservan la fuente del primer pago atribuido del cliente
- Beneficio por fuente con tu COGS
- Webhooks firmados, secreto por sitio guardado cifrado, cada evento contado una vez
- La IP nunca se guarda y nada de lo guardado identifica a un visitante
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 €. Stripe envía checkout.session.completed con la visita en client_reference_id, y Vero guarda la venta sin impuestos bajo esa fuente. La Checkout Session y su primera factura son una sola venta, así que cuenta una vez.
- 2Una renovación
Si ese cliente renueva, Stripe envía invoice.paid. Cuando la factura no trae visita, Vero busca el id de cliente de Stripe y acredita la renovación a la fuente de su primer pago atribuido. La primera factura de una prueba gratuita, que no cobra nada, no se guarda.
- 3Un reembolso
Si a ese cliente se le reembolsa, llega charge.refunded. Vero lo asocia a la venta por su cargo, su PaymentIntent o su factura, y lo resta de la fuente de esa venta, sin impuestos y en la misma proporción que la venta. Un reembolso parcial resta solo su parte.
- 4Una disputa
Vero solo resta reembolsos. Una disputa o un contracargo no se descuentan, así que la venta disputada 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 Stripe lo reintente y la venta no se pierda.
Si los números no cuadran.
La tarjeta dice «Último intento rechazado: firma no válida»
El secreto de firma guardado en Vero no es el del destino desde el que envía Stripe. Cada destino de webhook tiene su propio whsec_…, y uno en modo de prueba tiene otro distinto del de producción: cuando acabes de probar, pega el de producción. Vero también rechaza una firma cuyo timestamp se desvíe más de 5 minutos.
Una venta suma al total pero no tiene fuente
El pago llegó a Vero sin id de visita. Con Payment Links, activa el módulo checkout del tracker. Si tu servidor crea la Checkout Session, envía window.vero.session() desde la página y ponlo como client_reference_id. El id de visita solo cuenta si es de una visita de ese mismo sitio.
Una compra de prueba no suma ingresos
Es a propósito. Un pago con livemode: false se acepta con un 200 y no se cuenta, y la tarjeta muestra «Último intento ignorado: modo de prueba». Esa línea demuestra que la URL y el secreto funcionan. Si recibes un 404, el token del sitio en la URL está mal.
¿Conectar Stripe requiere cookies?
No. El tracker añade el id de sesión al Payment Link en el clic, y vuelve en el webhook firmado de Stripe. Vero sigue sin cookies.
¿Tengo que escribir código?
Con Payment Links, no. Pega la URL y el secreto, y activa el módulo checkout. Si creas las Checkout Sessions en tu servidor, envía window.vero.session() desde la página. Luego ponlo como client_reference_id.
¿Se reflejan los reembolsos?
Sí. Un charge.refunded se resta de la venta que devuelve y de su fuente, sin impuestos. Un reembolso parcial resta solo su parte. Cada canal se puntúa por lo que conservas.
¿El webhook es seguro?
Cada evento se comprueba con el secreto de firma del destino mediante HMAC-SHA256. Una firma de hace más de 5 minutos se rechaza. El secreto se guarda cifrado y un evento reenviado cuenta una vez.
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.
- Descubre qué canal trae a los clientes que pagan.Analítica sin cookies para SaaS: atribuye trials, activaciones e ingresos al canal exacto, sin IP almacenada, un tracker desde 1,2 KB y alertas de anomalías.