Integraciones · Proveedores de pagos
Ventas de Stripe, cada una vinculada a la visita que trajo al comprador.
Conecta Stripe con una clave restringida que solo puede leer. Tally importa tus últimos 365 días, recibe después cada pago en cuanto ocurre y lo vincula con un visitante a partir de la evidencia más sólida que tenga.
14 días gratis, sin tarjeta.
01Lo que lee Tally
- Cada pago una sola vez, por su PaymentIntent, venga de donde venga: Checkout, un Payment Link, una factura o un PaymentIntent creado por tu código.
- Suscripciones diferenciadas por la factura: un primer pago, una renovación o un cambio de plan; una prueba que pasa a pago cuenta como venta.
- Reembolsos, también los parciales, y contracargos: los fondos retirados cuentan en negativo y los restituidos, en positivo.
- Importes sin impuestos, en centavos de dólar estadounidense al tipo del Banco Central Europeo del día del pago, con las monedas sin decimales bien contadas.
- Los últimos 365 días al conectar y, después, cada pago en segundos mediante un endpoint de webhook que Tally crea en tu cuenta.
02Cómo encuentra una venta su visita
- Metadatos de CheckoutTu código pasa el ID del visitante como tally_visitor_id en los metadatos de la Checkout Session, y en subscription_data.metadata para que las renovaciones también lo lleven. Confianza alta.
- Payment LinksEl snippet añade por sí solo el ID del visitante a los enlaces de buy.stripe.com como client_reference_id, en modo con cookie y, en el modo «primero el consentimiento», una vez dado el consentimiento. Confianza alta.
- Página de éxitoTu URL de éxito lleva ?session_id={CHECKOUT_SESSION_ID}, y el visitante que vio primero esa página es el comprador. Confianza alta, y funciona en modo sin cookies.
- EmailTu sitio llama a tally('identify', { email }) y el email del cliente del pago coincide con él, ambos convertidos en hash. Confianza media.
- Renovaciones y reembolsosUna renovación o mejora de plan toma el vínculo del primer pago de la suscripción; un reembolso o contracargo toma el vínculo del pago que revierte.
03Lo que no puede leer
- Los pagos hechos con la antigua Charges API, que no tienen PaymentIntent, no se cuentan, y tampoco sus reembolsos ni sus disputas.
- Las facturas pagadas fuera de Stripe, marcadas como pagadas a mano o saldadas con saldo a favor no mueven dinero en Stripe, así que no se cuentan.
- Una cuenta de Stripe alimenta solo un sitio a la vez; si intentas conectarla a un segundo sitio, se rechaza hasta que la desconectes del primero.
- Las comisiones por disputa son un gasto, no ingresos, así que no se cuentan como contracargo.
04Cómo conectarlo
- En Stripe, abre Developers, API keys, elige Create restricted key y configura los permisos de abajo. Deja todo lo demás en None.
- Pega la clave en la página Integrations de tu sitio. Cada permiso se comprueba con una llamada real, así que, si falta alguno, se nombra antes de guardar nada.
- Tally guarda la clave cifrada, crea su propio endpoint de webhook en tu cuenta e importa los últimos 365 días.
- Para vínculos de confianza alta en las Checkout Sessions que crea tu código, la página Coverage te da las líneas que añadir, para Node, Next.js, Python, Ruby y PHP.
Lo que necesita la clave restringida
Tally pide una clave restringida 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é |
|---|---|---|
| PaymentIntents | Lectura | Cada pago: su importe, moneda, cliente y metadatos. |
| Invoices | Lectura | Si un pago es el primero de una suscripción, una renovación o un cambio de plan, y el impuesto que incluye. |
| Checkout Sessions | Lectura | El ID de visitante que pasas en los metadatos o en client_reference_id, y qué Payment Link hizo la venta. |
| Customers | Lectura | Los metadatos del cliente y su email para cotejarlo con tally('identify'): convertido en hash al instante, nunca almacenado. |
| Charges | Lectura | Reembolsos. |
| Disputes | Lectura | Contracargos, y fondos restituidos tras ganar una disputa. |
| Webhook Endpoints | Escritura | Tally crea su propio endpoint en tu cuenta para que los pagos lleguen en segundos. |
Dónde crearla: Stripe, Developers, API keys.
05Preguntas
¿Por qué una clave restringida y no mi clave secreta?
Una clave restringida solo puede hacer lo que tú permitas. Tally necesita leer pagos y crear un endpoint de webhook, nunca mover dinero, y puedes revocar la clave en Stripe cuando quieras. Una clave secreta se rechaza.
¿Las renovaciones conservan la fuente de la primera venta?
Sí. Una renovación o mejora de plan toma el vínculo del primer pago de la suscripción, así que los ingresos recurrentes se quedan con la visita que ganó al cliente. Pon también el ID del visitante en subscription_data.metadata y cada renovación lo llevará.
¿Funciona el modo de prueba?
Sí. Una clave restringida de modo de prueba se conecta igual que una real, y la integración muestra una insignia de modo de prueba, así que puedes probar todo el flujo antes con las tarjetas de prueba de Stripe.
¿Y los pagos en otras monedas?
Cada uno se convierte a centavos de dólar estadounidense al tipo de referencia del Banco Central Europeo de su día. Una moneda que el BCE no publica se conserva en su propio importe y se marca, en lugar de recibir un tipo inventado.