Connettore Stripe
Collega il tuo account Stripe a Tajo per sincronizzare in sola lettura i dati di pagamento, cioè clienti, addebiti, abbonamenti e fatture, verso la risoluzione dei contatti, la segmentazione e le automazioni basate sui ricavi (tramite Brevo e altri provider di engagement).
Panoramica
| Proprietà | Valore |
|---|---|
| Autenticazione | Chiave segreta Stripe (sk_live_... / sk_test_...) o chiave ristretta |
| Accesso | Sola lettura, Tajo non scrive mai sul tuo account Stripe |
| API di base | https://api.stripe.com/v1 |
| Direzione della sincronizzazione | Stripe → Tajo |
| Webhook in tempo reale | Non ancora, oggi la sincronizzazione avviene tramite polling |
Configurazione
- Nella dashboard di Stripe, apri Developers → API keys.
- Crea una chiave ristretta: è sufficiente il permesso di lettura su Customers, Charges, Subscriptions e Invoices. Una chiave ristretta è nettamente preferibile alla chiave segreta completa, perché Tajo legge soltanto, quindi concedi solo letture.
- Incolla la chiave nella connessione Stripe in Tajo.
La connessione viene validata con una richiesta in sola lettura prima che inizi qualsiasi sincronizzazione. Puoi ruotare o revocare la chiave in Stripe in qualsiasi momento.
Cosa viene sincronizzato
| Dato | Cosa ne fa Tajo |
|---|---|
| Clienti | Risolti in contatti (email, nome, telefono, indirizzo) per identità e segmentazione. Il consenso non viene mai dedotto dall’esistenza di un record cliente. |
| Addebiti | Eventi di ricavo per automazioni del ciclo di vita basate sugli acquisti e per la segmentazione per LTV |
| Abbonamenti | Stato del ciclo di vita (active, past_due, canceled…) per flussi di dunning, win-back e retention |
| Fatture | Stato del pagamento per la messaggistica legata alla fatturazione |
La paginazione usa il modello a cursore di Stripe (starting_after), così anche gli account di grandi dimensioni si sincronizzano per intero e in modo riprendibile.
Limiti attuali
Detti chiaramente, così puoi pianificare di conseguenza:
- Nessun webhook in tempo reale, per ora. Le modifiche arrivano secondo la pianificazione della sincronizzazione, non nel momento in cui un pagamento va a buon fine. L’ingestione dei webhook è in roadmap.
- Sola lettura. Tajo non crea e non modifica clienti, pagamenti o abbonamenti in Stripe.
- Nessuna Stripe App. Oggi non esiste nessuna app Tajo nello Stripe App Marketplace; la connessione si configura in Tajo, non nella dashboard di Stripe.
Risoluzione dei problemi
| Sintomo | Causa e soluzione |
|---|---|
| 401 da Stripe | Chiave revocata o ruotata: incolla la chiave corrente nella connessione |
| I clienti si sincronizzano ma gli addebiti no | Alla chiave ristretta manca il permesso di lettura su Charges |
| Il contatto non ha un’email | I clienti Stripe senza email si sincronizzano come record di ricavo anonimi; entrano nel grafo dei contatti se l’email viene aggiunta in seguito |
Passaggi successivi
- Sincronizzazione clienti: come mappare i clienti Stripe nel tuo sistema di riferimento
- Costruisci in Tajo automazioni di dunning e win-back sui cambi di stato degli abbonamenti