Saltar al contenido principal

Ve qué canal impulsa los ingresos de Paddle.

Vero verifica cada webhook de Paddle y registra la transacción. Pasa la visita como datos personalizados al abrir el checkout y la venta se acredita a la fuente que la ganó.

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 Paddle

    Pasas la sesión como datos personalizados al abrir Paddle.js.

    customData.vero
  3. 3El webhook firmado

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

    paddle-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/paddle?s=SITE_TOKEN
Cómo se configura

Tres pasos, sin código.

  1. 1Añade un webhook de Paddle a Vero con transaction.completed, adjustment.created y adjustment.updated; la firma (ts;h1) se verifica en cada evento.
  2. 2Abre Paddle.js con customData: { vero: window.vero.session() } y Vero lee la visita de los datos personalizados de la transacción.
  3. 3Las transacciones 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 Paddle
https://[tu-endpoint-vero]/api/revenue/paddle?s=YOUR_SITE_TOKEN
Eventos de Paddle
transaction.completed
adjustment.created
adjustment.updated

Qué obtienes

  • Verificación de firma de Paddle (HMAC con timestamp)
  • Transacciones completadas y reembolsos, duplicados ignorados
  • Beneficio por fuente con tu COGS y tu gasto en ads
  • 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 €. Paddle envía transaction.completed con la visita en data.custom_data.vero, y Vero guarda la venta sin impuestos bajo esa fuente. Una transacción que no cobra nada, como la primera de una prueba gratuita, no se guarda.

  2. 2Una renovación

    Si ese cliente renueva, Paddle envía otro transaction.completed. Cuando no trae visita, Vero busca el id de cliente de Paddle y acredita la renovación a la fuente de su primer pago atribuido.

  3. 3Un reembolso

    Si a ese cliente se le reembolsa, Paddle envía un ajuste con action refund. Vero solo lo descuenta cuando su estado es approved, así que un reembolso pendiente espera al adjustment.updated que lo aprueba. 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. Cualquier otra acción de ajuste, como un contracargo, se ignora, 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 Paddle 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»

Paddle firma cada webhook en Paddle-Signature (ts=…;h1=…), un HMAC-SHA256 sobre el timestamp y el cuerpo. Vero lo comprueba con el secreto guardado en Vero, así que pega el secreto de ese mismo destino de webhook. Una firma que se desvíe más de 5 minutos también se rechaza.

Una transacción suma al total pero no tiene fuente

La transacción volvió sin data.custom_data.vero. Abre Paddle.js con customData: { vero: window.vero.session() } allí donde empiece un checkout. La venta cuenta igual, y hereda la fuente de un pago anterior atribuido del cliente si lo hay. El id de visita solo cuenta si es de una visita de ese mismo sitio.

Una transacción del sandbox no suma ingresos

Vero reconoce un webhook del sandbox por las direcciones IP desde las que Paddle los envía, lo acepta con un 200 y lo ignora como modo de prueba. La tarjeta muestra «Último intento ignorado: modo de prueba», lo que demuestra que la URL y el secreto funcionan. Un token del sitio erróneo tras ?s= recibe un 404, y si falta, un 400.

¿Se comprueba la firma de Paddle?

Sí: Vero verifica el HMAC con timestamp (ts;h1) contra un secreto por sitio, guardado cifrado, antes de aceptar un evento.

¿Gestiona reembolsos?

Sí, en cuanto Paddle lo aprueba. Suscribe el webhook a adjustment.created y adjustment.updated, además de a transaction.completed. Un reembolso se resta de la transacción que devuelve y de su fuente, sin impuestos.

¿Requiere cookies?

No: la sesión viaja como datos personalizados del checkout y vuelve en el webhook firmado.

Atribuye tus ingresos de Paddle

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

Ver la demo