Integraciones · Proveedores de pagos
Pedidos y renovaciones de Lemon Squeezy, vinculados a sus visitas.
Conecta una tienda de Lemon Squeezy con una clave de API. Tally lee los pedidos y las facturas de suscripción con sus reembolsos, y vincula cada venta con el visitante cuyo ID llegó en los datos personalizados del checkout, o por el email del comprador.
14 días gratis, sin tarjeta.
01Lo que lee Tally
- Los pedidos como ventas nuevas y las facturas de suscripción como renovaciones o cambios de plan; el primer pago de una suscripción se cuenta una vez, como su pedido.
- Reembolsos, totales o parciales, a partir del total reembolsado acumulado que lleva Lemon Squeezy, así que cada nuevo total suma solo lo que cambió.
- Tiendas en modo de prueba y en modo real por igual: decide el modo de la propia clave.
- Importes sin impuestos, en centavos de dólar estadounidense al tipo de referencia del día.
02Cómo encuentra una venta su visita
- Datos personalizados del enlace de checkoutAñade checkout[custom][tally_visitor_id] a un enlace de checkout, o ponlo en checkout_data.custom cuando tu servidor cree el checkout.
- EmailEl email del comprador, convertido en hash, coincide con una llamada a tally('identify'). Es el único vínculo para los pedidos hechos antes de conectar.
- Renovaciones y reembolsosUna factura de suscripción toma el vínculo de su primer pedido; un reembolso cuenta contra el pedido o la factura a la que pertenece.
03Lo que no puede leer
- Lemon Squeezy no informa de contracargos: reembolsa por su cuenta un pedido en disputa, y eso llega como un reembolso.
- Su API no devuelve los datos personalizados, así que los pedidos anteriores a la conexión solo pueden vincularse por email.
- El snippet no etiqueta por sí solo los enlaces de checkout de Lemon Squeezy; la página Coverage da las pocas líneas que lo hacen.
- Las claves de API no tienen ámbitos, así que el acceso mínimo es una clave creada solo para Tally y que no use nada más.
04Cómo conectarlo
- En Lemon Squeezy, abre Settings, API, y crea una clave solo para Tally.
- Pégala en la página Integrations de tu sitio. Una clave ve todas las tiendas de su cuenta, así que indica la tienda cuando haya más de una.
- Tally crea un webhook para esa tienda con un secreto propio e importa los últimos 365 días.
- Añade el ID del visitante a tus enlaces de checkout o a checkout_data, como muestra la página Coverage.
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é |
|---|---|---|
| Orders | Lectura | Cada venta: su importe, impuestos y reembolsos, y el email del cliente (convertido en hash al instante, nunca almacenado). |
| Subscription invoices | Lectura | Renovaciones y cambios de plan. |
| Webhooks | Escritura | Tally añade su propio webhook a la tienda para que los pagos lleguen en segundos. |
Dónde crearla: Lemon Squeezy, Settings, API.
05Preguntas
¿Puedo conectar más de una tienda de Lemon Squeezy?
Cada tienda alimenta un sitio. Si una clave ve varias tiendas, te pregunta cuál quieres, por ID, slug, dominio o nombre, y una tienda que ya alimenta otro sitio se rechaza.
¿Cómo se cuentan los reembolsos parciales?
Lemon Squeezy lleva un importe reembolsado acumulado en lugar de reembolsos separados, así que Tally guarda cada nuevo total como lo que añade. Lleguen en el orden que lleguen, el webhook y la importación acaban en la misma suma, con el impuesto reembolsado en proporción.
¿Por qué los pedidos antiguos no tienen fuente?
La API de Lemon Squeezy no devuelve los datos personalizados que llevaba un checkout, así que los pedidos anteriores a la conexión solo pueden vincularse por el email del comprador. Los pedidos de ahí en adelante llevan el ID del visitante.