Conector de Stripe
Conecta tu cuenta de Stripe a Tajo para sincronizar en modo solo lectura los datos de pago, es decir clientes, cargos, suscripciones y facturas, hacia la resolución de contactos, la segmentación y las automatizaciones basadas en ingresos (mediante Brevo y otros proveedores de interacción).
Resumen
| Propiedad | Valor |
|---|---|
| Autenticación | Clave secreta de Stripe (sk_live_... / sk_test_...) o clave restringida |
| Acceso | Solo lectura, Tajo nunca escribe en tu cuenta de Stripe |
| API base | https://api.stripe.com/v1 |
| Sentido de la sincronización | Stripe → Tajo |
| Webhooks en tiempo real | Todavía no, hoy la sincronización se basa en sondeo |
Configuración
- En el panel de control de Stripe, abre Developers → API keys.
- Crea una clave restringida, basta con permiso de lectura sobre Customers, Charges, Subscriptions e Invoices. Una clave restringida es muy preferible a la clave secreta completa: Tajo solo lee, así que concede solo lecturas.
- Pega la clave en la conexión de Stripe en Tajo.
La conexión se valida con una petición de solo lectura antes de que empiece cualquier sincronización. Puedes rotar o revocar la clave en Stripe cuando quieras.
Qué se sincroniza
| Datos | Qué hace Tajo con ellos |
|---|---|
| Clientes | Se resuelven en contactos (email, nombre, teléfono, dirección) para identidad y segmentación. El consentimiento nunca se deduce de que exista un registro de cliente. |
| Cargos | Eventos de ingresos para automatizaciones de ciclo de vida basadas en compras y segmentación por LTV |
| Suscripciones | Estado del ciclo de vida (active, past_due, canceled…) para flujos de recobro, recuperación y retención |
| Facturas | Estado de pago para los mensajes relacionados con la facturación |
La paginación usa el modelo de cursor de Stripe (starting_after), así que las cuentas grandes se sincronizan por completo y se pueden reanudar.
Limitaciones actuales
Dichas sin rodeos para que puedas planificar teniéndolas en cuenta:
- Todavía no hay webhooks en tiempo real. Los cambios llegan según la planificación de la sincronización, no en el momento en que se completa un pago. La ingesta de webhooks está en la hoja de ruta.
- Solo lectura. Tajo no crea ni modifica clientes, pagos ni suscripciones en Stripe.
- No hay Stripe App. Hoy no existe ninguna app de Tajo en el Stripe App Marketplace; la conexión se configura en Tajo, no en el panel de control de Stripe.
Resolución de problemas
| Síntoma | Causa y solución |
|---|---|
| 401 desde Stripe | La clave se revocó o se rotó, pega la clave actual en la conexión |
| Los clientes se sincronizan, pero los cargos no | A la clave restringida le falta el permiso de lectura sobre Charges |
| El contacto no tiene email | Los clientes de Stripe sin email se sincronizan como registros de ingresos anónimos; se incorporan al grafo de contactos si el email se añade más adelante |
Siguientes pasos
- Sincronización de clientes, cómo mapear los clientes de Stripe en tu sistema de registro
- Crea en Tajo automatizaciones de recobro y de recuperación a partir de los cambios de estado de las suscripciones