---
title: "Connettore Stripe"
description: "Collega Stripe a Tajo con una API key ristretta per sincronizzare in sola lettura clienti, addebiti, abbonamenti e fatture nei flussi di engagement e migrazione."
url: https://tajo.io/it/docs/connectors/ecommerce/stripe/
markdown: https://tajo.io/it/docs/connectors/ecommerce/stripe.md
lang: it-IT
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

# Connettore Stripe

Stato del connettore: Attivo Verificato. Tajo esegue oggi questo connettore.

| Campo di origine | Campo di destinazione | Valore di esempio |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

1. Nella dashboard di Stripe, apri **Developers → API keys**.
2. 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.
3. 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](https://tajo.io/it/docs/skills/data-sync/customer-sync/): 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