Integraciones · Proveedores de pagos
Pedidos y suscripciones de Polar, cada uno con su fuente.
Conecta Polar con un token de acceso de organización limitado a cinco ámbitos. Tally lee las compras y los ciclos de suscripción con sus reembolsos y disputas perdidas, y vincula cada uno con el visitante mediante los metadatos del checkout, la referencia de un enlace de checkout o el email.
14 días gratis, sin tarjeta.
01Lo que lee Tally
- Los pedidos pagados que mueven dinero: compras y primeros pagos de suscripciones como nuevos, ciclos y ciclos por uso como renovaciones, cambios de plan como mejoras.
- Reembolsos pendientes o completados; uno que falla o se cancela añade su reversión, así que el par suma cero.
- Las disputas perdidas como contracargos, sin su impuesto.
- Importes después de descuentos y antes de impuestos, en centavos de dólar estadounidense al tipo de referencia del día.
- Los tokens de sandbox se conectan en modo de prueba.
02Cómo encuentra una venta su visita
- Metadatos del checkoutEl ID del visitante en los metadatos de un checkout, que Polar copia a su pedido y a su suscripción.
- Enlaces de checkoutEl reference_id de un enlace de checkout llega a los metadatos del checkout y se vincula como un Payment Link de Stripe.
- EmailEl email del cliente, convertido en hash al instante, coincide con una llamada a tally('identify'). Confianza media.
03Lo que no puede leer
- Polar no envía ningún evento de disputa, así que una disputa perdida se lee la próxima vez que cambia su pedido, o al reimportar.
- El snippet no etiqueta por sí solo los enlaces de checkout de Polar; lo hacen unas pocas líneas en tu página, para los enlaces que el embed de Polar marca con data-polar-checkout.
- Los pedidos que no mueven dinero, como los de productos gratuitos, no son ventas y no se cuentan.
04Cómo conectarlo
- En Polar, abre Settings, Access Tokens, y crea un token de organización con los cinco ámbitos de abajo.
- Pégalo en la página Integrations de tu sitio; se comprueba cada ámbito, y un token del sandbox se reconoce como modo de prueba.
- Tally crea su propio endpoint de webhook e importa los últimos 365 días, reembolsos y disputas perdidas incluidos.
- Pon el ID del visitante en los metadatos del checkout, o en el reference_id de los enlaces de checkout, como muestra la página Coverage.
Lo que necesita el token de acceso
Tally pide un token de acceso que solo pueda hacer esto y comprueba cada permiso con una llamada real al pegarlo, así que se nombra el que falte:
| Permiso | Acceso | Para qué |
|---|---|---|
| Organizations | organizations:read | El nombre de la organización, para que sepas cuál está conectada. |
| Orders | orders:read | Cada pago: su importe, impuestos, metadatos y el email del cliente (convertido en hash al instante, nunca almacenado). |
| Refunds | refunds:read | Reembolsos. |
| Disputes | disputes:read | Contracargos: las disputas que perdiste. |
| Webhooks | webhooks:write | Tally añade su propio endpoint de webhook para que los pagos lleguen en segundos. |
Dónde crearla: Polar, Settings, Access Tokens.
05Preguntas
¿Tally cuenta el consumo por uso que factura Polar?
Sí: un pedido de un ciclo de suscripción por uso es una renovación, contada por el importe que cobró Polar y atribuida a la visita que ganó al cliente.
¿Por qué Polar necesita el ámbito de disputas?
Polar no envía ningún evento de disputa, así que Tally lee la Disputes API para encontrar las disputas que perdiste y contarlas como contracargos contra la venta.
¿Puedo probarlo primero en el sandbox de Polar?
Sí. Pega un token de sandbox y la integración se conecta en modo de prueba, con su propio webhook, para que compruebes un checkout de sandbox de principio a fin.