Integraciones · Proveedores de pagos
Transacciones, renovaciones y reembolsos de Paddle, vinculados a la visita.
Conecta Paddle Billing con una clave de API limitada a cuatro permisos. Tally lee cada transacción completada, distingue las ventas nuevas de las renovaciones y mejoras de plan, y vincula cada una con el visitante cuyo ID viajó en los datos personalizados del checkout.
14 días gratis, sin tarjeta.
01Lo que lee Tally
- Cada transacción que Paddle completa: checkouts de Paddle.js, los creados por la API y los ciclos de suscripción.
- El tipo, según el origen de la transacción: una venta nueva, una renovación o una mejora de plan, con los cargos únicos sobre una suscripción contados como expansión; una prueba que pasa a pago cuenta como nueva.
- Reembolsos y contracargos a partir de los ajustes, una vez que Paddle los aprueba; los créditos no mueven dinero y quedan fuera.
- Importes antes de impuestos, convertidos a centavos de dólar estadounidense al tipo de referencia del día.
- Las claves de sandbox se conectan en modo de prueba, así que puedes probar un checkout de sandbox de principio a fin.
02Cómo encuentra una venta su visita
- customData de Paddle.jsPasa el ID del visitante como tally_visitor_id en customData al abrir el checkout. Paddle lo copia de la suscripción a cada renovación, así que también quedan vinculadas.
- custom_data de la transacciónUna transacción que crea tu servidor lleva la misma clave en su custom_data.
- EmailEl email del cliente, convertido en hash al instante, coincide con una llamada a tally('identify') en tu sitio. Confianza media.
03Lo que no puede leer
- Paddle no documenta ninguna forma de llevar el ID del visitante por su checkout alojado ni por el enlace de pago predeterminado, así que esas ventas solo se vinculan por email.
- Las claves de API heredadas, creadas antes de que Paddle añadiera permisos, no se pueden limitar, así que se rechazan.
- Un reembolso que aún espera la aprobación de Paddle no se cuenta hasta que se aprueba; uno rechazado, nunca.
- Los ajustes de transacciones anteriores a los 365 días importados no se incorporan.
04Cómo conectarlo
- En Paddle, abre Developer tools, Authentication, y crea una clave de API con los cuatro permisos de abajo.
- Pégala en la página Integrations de tu sitio; cada permiso se comprueba con una llamada propia.
- Tally añade su propio destino de notificaciones en Paddle e importa las transacciones de los últimos 365 días.
- Añade tally_visitor_id a customData donde abras los checkouts de Paddle.js; la página Coverage tiene las líneas para tu página y para las transacciones que crea tu servidor.
Lo que necesita la clave de API
Tally pide una clave de API que solo pueda hacer esto y comprueba cada permiso con una llamada real al pegarla, así que se nombra el que falte:
| Permiso | Acceso | Para qué |
|---|---|---|
| Transaction | Lectura | Cada pago: su importe, impuestos, origen y datos personalizados. |
| Adjustment | Lectura | Reembolsos y contracargos. |
| Customer | Lectura | El email del cliente para cotejarlo con tally('identify'): convertido en hash al instante, nunca almacenado. |
| Notification setting | Escritura | Tally añade su propio destino de notificaciones para que los pagos lleguen en segundos. |
Dónde crearla: Paddle, Developer tools, Authentication.
05Preguntas
¿Tally funciona con Paddle Classic?
Tally lee Paddle Billing, versión 1 de la API, con claves que tienen permisos. Una clave heredada sin permisos se rechaza con una frase que lo explica.
¿Por qué Paddle necesita cuatro permisos?
Transacciones para los pagos, ajustes para los reembolsos y contracargos, clientes para cotejar el email, y la configuración de notificaciones para que Tally añada su propio destino y se entere de cada pago en segundos.
¿Se cuentan los contracargos?
Sí: un ajuste de contracargo aprobado es un contracargo negativo, y uno revertido vuelve como positivo, así que el par se compensa con la venta a la que pertenece.