Come collegare Stripe a Excel - Interrogare i dati di pagamento con SQL

Collega Stripe a Excel

Ottieni i dati da Striscia in Excel

Importa i dati in tempo reale dal tuo account Stripe in Excel e aggiornali quando vuoi. Nessun driver ODBC, nessuna esportazione, nessuna macro. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.

Circa 10 minuti Non è necessaria alcuna programmazione. Le credenziali restano con te Eccelli ovunque, anche sul web.

Quello che otterrai alla fine

Un foglio di calcolo che mostra i risultati in tempo reale di una query SQL sul tuo account Stripe, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:

Vendite.xlsx — Excel

CasaInserisciDatiFlussi di query

	A	B	C	D	E
1	ID cliente	nome di battesimo	cognome	Paese	totale
2	1042	Maria	Alvarez	U.S.A.	1,284.50
3	1043	Daniel	Okafor	U.S.A.	612.00
4	1047	Priya	Nair	U.S.A.	2,090.75
5	1051	Tommaso	Berg	U.S.A.	338.20
6	1056	Lucia	Ferreira	U.S.A.	1,455.00
7	1060	Kenji	Sato	U.S.A.	874.10
8

Foglio1 In diretta da Stripe

Stripe protegge i tuoi dati tramite la sua API. Importarli in Excel di solito significa esportare un file CSV dalla dashboard di Stripe ogni volta che hai bisogno di dati aggiornati. Query Streams elimina questo passaggio: un piccolo programma di supporto chiamato Agent esegue la query direttamente dove si trovano i tuoi dati e un componente aggiuntivo di Excel richiede le righe desiderate. Solo i risultati vengono trasmessi, tramite un collegamento crittografato, e il file Excel può trovarsi ovunque: sul tuo laptop a casa, sul computer di un collega dall'altra parte del paese o su Excel sul web.

Cosa ti servirà

Un account Query Streams

Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.

L'agente su qualsiasi computer sempre acceso

Un piccolo programma che viene eseguito in background e si connette a Stripe quando Excel lo richiede. Richiede solo una connessione a Internet.

Le tue credenziali di accesso a Stripe

Dovrai accedere a Stripe una sola volta e consentire l'accesso in lettura. Non è necessario inserire password in Query Streams.

Collegalo in cinque passaggi

1. Crea il tuo account

   Vai a my.querystreams.com e iscriviti. Scegli il Gratuito piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione del tuo account Stripe e l'esecuzione di query da Excel.

2. Installa l'agente su qualsiasi computer sempre acceso.

   Accedi, apri Scaricamentoe installa l'agente su qualsiasi computer o server sempre acceso con accesso a Internet. L'operazione richiede un minuto e da quel momento in poi si avvia automaticamente.

   Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Le chiavi rimangono sul computer e le righe vengono inviate ovunque vi troviate, anche tramite Internet se necessario. L'unico elemento che dovete gestire è il componente aggiuntivo.

   La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.

   Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

3. Puntalo al tuo account Stripe

   Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore e scegliere StrisciaHai bisogno prima delle tue credenziali Stripe? Apri la guida, quindi compila i campi richiesti:

   Crea le tue credenziali Stripe (circa 8 minuti)

   Continuate così con Stripe aperto in un'altra scheda. Query Streams conserva i dati che create qui, in modo che il vostro agente possa utilizzarli, e legge esclusivamente da Stripe.

   Chi può farlo?

   Titolare dell'account, Super Amministratore, Amministratore o Sviluppatore (i ruoli di Stripe che possono creare chiavi API)

   Raccomandato

   Chiave API con restrizioni e permessi di sola lettura (rk_live_… per i dati in tempo reale, rk_test_… per un ambiente di test)

   Prima di iniziare

   • Un account Stripe con i ruoli di Titolare dell'account, Super Amministratore, Amministratore o Sviluppatore. Altri ruoli (Analista, Solo visualizzazione, Supporto e così via) non consentono la creazione di chiavi API.
   • Accesso alla casella di posta elettronica o al numero di telefono a cui Stripe invia i codici di verifica. Stripe richiede un codice prima di creare la chiave.
   • La procedura guidata Query Streams si apre in un'altra scheda (Agenti dati → Aggiungi connettore → Stripe) con il tuo agente online, così puoi incollare la chiave non appena Stripe la visualizza.

   Passaggi

   1. Accedi e scegli tra dati reali o un ambiente di test (sandbox).

      Accedi alla dashboard di Stripe. Stripe mantiene separati i dati reali e i dati di test (sandbox), ognuno con la propria chiave. Per i pagamenti reali, utilizza il tuo account aziendale e non un'area di test. Per i dati di test, apri il selettore account nella dashboard, fai clic su "Sandbox" e apri l'area di test desiderata.

      Una chiave di produzione non può leggere i dati di sandbox e una chiave di sandbox non può leggere i dati di produzione. Se desideri entrambe le opzioni, crea una chiave per ciascuna e aggiungi ciascuna come connettore Stripe separato in Query Streams.

   2. Apri la pagina delle chiavi API

      Apri la pagina delle chiavi API. Dalla Dashboard puoi anche cliccare su Sviluppatori (in basso a sinistra) e scegliere Chiavi API. La pagina contiene due elenchi: Chiavi standard (chiavi pubblicabili e segrete) e Chiavi con restrizioni.

      Stai usando una sandbox? Apri prima la sandbox (passaggio 1). Ogni sandbox ha la sua pagina delle chiavi API e le sue chiavi.

   3. Avviare una chiave con restrizioni

      Nell'elenco Chiavi con restrizioni, fai clic su Crea chiave con restrizioni. In alcuni account viene visualizzato come + Crea chiave con restrizioni.

      Non utilizzare la chiave pubblicabile (pk_…). Non può leggere i dati dell'account. Anche una chiave segreta (sk_…) funziona in Query Streams, ma può eseguire qualsiasi operazione sul tuo account, inclusi rimborsi e pagamenti. Stripe consiglia di utilizzare chiavi con restrizioni, e Query Streams deve solo leggere i dati.

   4. Descrivi come verrà utilizzata la chiave

      Stripe ti chiede come intendi utilizzare la chiave. Seleziona "Crea la tua integrazione", quindi fai clic su Continua.

      Non selezionare "Autorizza l'accesso dell'agente al tuo account". Questa opzione contrassegna la chiave per gli agenti AI e aggiunge le regole di approvazione di Stripe. Se hai selezionato per errore "Fornisci questa chiave a un altro sito Web", seleziona "Personalizza le autorizzazioni per questa chiave" nella schermata successiva. Se la lasci deselezionata, Stripe assegnerà alla chiave le autorizzazioni predefinite anziché l'elenco di sola lettura indicato al passaggio 7.

   5. Partire senza permessi

      Stripe offre modelli di autorizzazione predefiniti oppure la possibilità di iniziare da zero. Scegliendo di iniziare da zero (selezionando le tue autorizzazioni), tutte le autorizzazioni partiranno da Nessuna.

      Stripe modifica spesso la dicitura in questa schermata. Cerca un'opzione con diciture come "Inizia da zero" o "Scegli il mio", non un modello. Se la schermata non è presente, passa direttamente al passaggio 6.

   6. Dai un nome alla chiave

      Nel campo Nome chiave, digita un nome che riconoscerai in seguito, ad esempio Query Streams (sola lettura).

   7. Imposta la lettura sulle 13 risorse Query Streams sincronizzate

      Ogni riga di risorsa ha tre opzioni: Nessuna, Lettura e Scrittura. Fai clic su Lettura per queste 13 righe e lascia tutte le altre righe su Nessuna. Sotto Core: Saldo, Origini delle transazioni di saldo, Addebiti e rimborsi, Clienti, Controversie, Eventi, Intenzioni di pagamento, Pagamenti, Prodotti. Sotto Fatturazione: Buoni sconto, Fatture, Prezzi, Abbonamenti. Per trovare rapidamente una riga, premi Ctrl+F (Cmd+F su Mac) e digita la prima parola del suo nome.

      Non selezionare mai l'opzione Scrittura. Query Streams esegue solo operazioni di lettura, quindi una chiave con sola autorizzazione di lettura non può creare addebiti, rimborsi o pagamenti, anche in caso di perdita di dati. È necessario utilizzare Eventi anche se non si sincronizza mai la tabella degli eventi, perché Query Streams legge l'elenco degli eventi di Stripe per rilevare le modifiche tra una sincronizzazione e l'altra. Se si utilizza Connect, lasciare le autorizzazioni dell'account connesso su Nessuno. Se il nome di una riga non corrisponde a quello visualizzato, fare clic su Lettura nelle righe di intestazione Tutte le risorse principali e Tutte le risorse di fatturazione. La chiave rimane di sola lettura, ma può leggere più dati di quanti ne utilizzi Query Streams.

   8. Crea la chiave

      Fai clic su Crea chiave.

   9. Inserisci il codice di verifica

      Stripe invia un codice di verifica via e-mail o SMS. Inseriscilo nella finestra di dialogo. Se la finestra di dialogo non procede automaticamente, fai clic su Continua.

      Nessun codice? Controlla la cartella spam o il numero di telefono nel tuo profilo Stripe.

   10. Copia la chiave

       Stripe ora mostra la nuova chiave. Inizia con rk_live_ (o rk_test_ in un ambiente sandbox). Fai clic sul valore della chiave per copiarlo, quindi incollalo direttamente in Chiave segreta di Stripe nella procedura guidata Query Streams.

       In modalità live, Stripe mostra la chiave che hai creato solo quella volta e non può rivelarla in seguito. Le chiavi sandbox possono essere rivelate in qualsiasi momento. Non inviare la chiave tramite e-mail o chat. Query Streams la memorizza per il tuo agente e la utilizza esclusivamente per leggerla.

   11. Nota dove viene utilizzata la chiave

       Nella finestra "Aggiungi una nota", specifica dove viene utilizzata la chiave, ad esempio "Agente Query Streams sul computer dell'ufficio". Quindi fai clic su "Fine". La chiave ora compare nell'elenco "Chiavi con restrizioni".

       La nota viene visualizzata ogni volta che tu o un collega rivedete le vostre chiavi, in modo che nessuno la faccia scadere per sbaglio.

   Autorizzazioni a concedere

   Risorsa	Accesso	Utilizzato per
   Clienti	Leggere	tabella clienti. Anche il test di connessione la legge per primo.
   Costi e rimborsi	Leggere	Tabelle relative a costi e rimborsi. Un'unica riga comprende entrambi gli aspetti e non è presente una riga separata per i rimborsi.
   Intenzioni di pagamento	Leggere	tabella delle intenzioni di pagamento
   Spese	Leggere	Tabelle invoices e invoice_items. Gli elementi della fattura non hanno una riga propria.
   Abbonamenti	Leggere	tabelle subscriptions e subscription_items
   Saldo	Leggere	Tabella balance_transactions (elenco delle transazioni di saldo di Stripe, precedentemente chiamata Cronologia del saldo)
   Fonti delle transazioni di saldo	Leggere	Tabella balance_transactions: consente di collegare ogni transazione all'addebito, al rimborso o al pagamento corrispondente. Stripe afferma che ciò concede anche l'autorizzazione di lettura su saldo e pagamenti.
   Pagamenti	Leggere	tabella dei pagamenti
   Controversie	Leggere	tabella delle controversie
   Prodotti	Leggere	tabella dei prodotti
   Prezzi	Leggere	tabella dei prezzi
   Buoni sconto	Leggere	tabella dei coupon
   Eventi	Leggere	tabella degli eventi e il feed delle modifiche che mantiene aggiornati clienti, abbonamenti, fatture, voci di fattura, addebiti, intenzioni di pagamento, rimborsi, contestazioni, pagamenti, prodotti, prezzi e coupon tra le sincronizzazioni

   Incolla nei flussi di query

   Chiave segreta di Stripe

   La chiave protetta che hai copiato al passaggio 10 (inizia con rk_live_ o rk_test_). Anche una chiave segreta (sk_live_ o sk_test_) funziona, ma può fare molto di più che leggere.

   Problemi comuni

   Il test di connessione fallisce a causa di una chiave API non valida.

   Perché: Durante la copia, una parte della chiave è andata persa, è stato aggiunto uno spazio, è stata incollata la chiave pubblicabile (pk_…) oppure qualcuno ha fatto scadere o ruotare la chiave in Stripe.

   Aggiustare: La chiave deve iniziare con rk_ o sk_. Incollala di nuovo senza nulla prima o dopo. Se non la possiedi più (Stripe mostra le chiavi attive una sola volta), crea una nuova chiave con restrizioni (passaggi da 3 a 11) e incolla quella.

   Il test di connessione indica "Connesso", ma alcune tabelle rimangono vuote e la loro sincronizzazione mostra un errore di autorizzazione di Stripe (403). Gli agenti più recenti mostrano anche un avviso sotto "Test di connessione" che elenca le tabelle che la chiave non può leggere.

   Perché: La chiave manca per l'autorizzazione di lettura sulla riga della tabella. Il messaggio di errore di Stripe specifica l'autorizzazione mancante, ad esempio rak_event_read significa Eventi.

   Aggiustare: Nella pagina delle chiavi API di Stripe, fai clic sul menu ⋯ accanto alla chiave, scegli Modifica chiave, imposta la riga mancante su Lettura e salva. La chiave stessa non cambia, quindi non c'è nulla da incollare di nuovo. Fai di nuovo clic su Verifica connessione in Query Streams.

   La connessione è attiva, ma vengono visualizzati solo dati di prova oppure le tabelle risultano vuote nonostante vengano elaborati pagamenti reali.

   Perché: La chiave proviene da un ambiente di test (rk_test_) quando si desideravano dati reali, o viceversa.

   Aggiustare: Verifica come inizia la chiave. Per i dati di produzione, usa il selettore account per uscire dalla sandbox, crea nuovamente la chiave (passaggi da 2 a 11), quindi apri il connettore in Data Agents, fai clic su Modifica e incollalo in Chiave segreta di Stripe. Mantieni i connettori di test e di produzione separati.

   Un connettore che prima funzionava smette di sincronizzarsi con il messaggio "Chiave API non valida".

   Perché: Qualcuno ha ruotato o fatto scadere la chiave in Stripe. Una chiave ruotata continua a funzionare solo fino alla scadenza scelta al momento della rotazione, che è al massimo di 7 giorni.

   Aggiustare: Crea una nuova chiave con restrizioni oppure copia la chiave sostitutiva dalla rotazione. In Query Streams, apri il connettore, fai clic su Modifica, incolla la chiave in Chiave segreta Stripe, fai clic su Verifica connessione, quindi fai clic su Salva.

   Non è possibile visualizzare l'opzione "Crea chiave con restrizioni" oppure la pagina delle chiavi API non si apre.

   Perché: Il tuo ruolo in Stripe non ti consente di gestire le chiavi API. I ruoli Analista, Solo visualizzazione e Supporto non possono farlo.

   Aggiustare: Chiedi al titolare del tuo account Stripe, a un amministratore o a uno sviluppatore di creare la chiave per te, oppure di modificare il tuo ruolo.

   Stripe ti invia un'email informandoti di aver bloccato una richiesta e che le sincronizzazioni falliscono anche se la chiave è corretta.

   Perché: Una policy di accesso sulla chiave (indirizzi IP o avanzata) non consente l'indirizzo Internet del computer dell'agente oppure blocca una VPN o un proxy utilizzato dal computer.

   Aggiustare: Nella pagina delle chiavi API, fai clic su ⋯ accanto alla chiave, scegli Gestisci criteri di accesso e seleziona un criterio che consenta l'indirizzo IP pubblico del computer dell'agente oppure scegli Nessuno. Quindi fai clic su Salva.

   La chiave è stata esposta (inviata tramite e-mail o chat, oppure salvata in un file condiviso), oppure qualcuno che la possedeva ha lasciato il tuo team.

   Perché: Chiunque sia in possesso della chiave può leggere tutto ciò che le autorizzazioni consentono.

   Aggiustare: Nella pagina delle chiavi API, fai clic su ⋯ accanto alla chiave e scegli Ruota chiave. In Scadenza, seleziona Ora per eliminare immediatamente la vecchia chiave, quindi fai clic su Ruota chiave API. Copia la nuova chiave e incollala nel connettore (Modifica → Chiave segreta Stripe → Verifica connessione → Salva).

   Desideri che Query Streams smetta di leggere questo account Stripe.

   Perché: L'eliminazione del connettore non disabilita la chiave. Questa rimane valida in Stripe fino alla sua scadenza.

   Aggiustare: Nella pagina delle chiavi API, fai clic su ⋯ accanto alla chiave, scegli Scadenza chiave e fai nuovamente clic su Scadenza chiave per confermare. Quindi elimina il connettore in Data Agents.

   Limiti da conoscere

   • Gli eventi risalgono a 30 giorni prima. L'elenco degli eventi di Stripe si estende solo fino a 30 giorni prima, quindi la tabella degli eventi non contiene mai dati risalenti a più di 30 giorni. Query Streams legge anche gli eventi per rilevare le modifiche tra una sincronizzazione e l'altra, quindi se un connettore viene disattivato per più di quattro settimane circa, la successiva sincronizzazione legge nuovamente le relative tabelle per intero.
   • Velocità delle richieste: Stripe consente 100 richieste API al secondo in modalità live e 25 in un ambiente sandbox, e la maggior parte degli endpoint individuali ne consente 25. Ogni richiesta restituisce al massimo 100 record, quindi una prima sincronizzazione di 1.000.000 di addebiti richiede circa 10.000 richieste, ovvero circa 7 minuti a 25 richieste al secondo. Le sincronizzazioni in ambiente sandbox sono più lente.
   • Limite mensile di letture: Stripe prevede che le richieste di lettura di un account non superino in media 500 per transazione nell'arco di 30 giorni consecutivi, con un minimo di 10.000 al mese. Ogni tabella abilitata effettua almeno una richiesta ogni volta che si sincronizza, quindi, per un account nuovo o con un basso volume di transazioni, è consigliabile impostare intervalli di sincronizzazione più lunghi per le tabelle che non necessitano di una sincronizzazione minuto per minuto.
   • Una modalità per ogni chiave: una chiave legge solo la modalità in cui è stata creata (live o una specifica sandbox).
   • Connetti: la chiave legge solo gli oggetti del tuo account. I pagamenti sugli account collegati non vengono sincronizzati.
   • Visualizzazione della chiave: Stripe mostra la chiave attiva creata una sola volta, mentre le chiavi di test possono essere visualizzate in qualsiasi momento. Quando si ruota una chiave, quella precedente continua a funzionare per un massimo di 7 giorni.

   Passaggi verificati l'8 ottobre 2026. Fonti: docs.stripe.com/keys, docs.stripe.com/keys/restricted-api-keys, docs.stripe.com/keys-best-practices, docs.stripe.com/stripe-apps/reference/permissions, docs.stripe.com/sandboxes, docs.stripe.com/testing-use-cases, docs.stripe.com/rate-limits, docs.stripe.com/api/events/list, docs.stripe.com/api/balance_transactions/list, docs.stripe.com/api/errors, docs.stripe.com/get-started/account/teams/roles, docs.stripe.com/workbench, support.stripe.com/questions/plugin-user-migration-guide, stripe.com/sessions/2026/building-security-first-stripe, posthog.com/docs/cdp/sources/stripe, help.chaserhq.com/use-chaser-with-stripe, homerunner.io/docs/creating-stripe-restrict-key-for-homer…, chargebee.com/docs/reveal/transactions/get-started/stripe…, nango.dev/docs/api-integrations/stripe-api-key/connect, fivetran.com/docs/connectors/applications/stripe/troubles….

   Nome della società

   Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".

   Chiave segreta di Stripe

   Puoi trovare la tua chiave segreta Stripe nella dashboard di Stripe, alla voce Sviluppatori, Chiavi API; inizia con sk_live_ o sk_test_.

   Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.

   Agenti di dati aperti

   Test fallito? Solitamente manca un'autorizzazione o le credenziali dell'account Stripe sbagliato. La procedura guidata sopra elenca problemi comuni e le relative soluzioni.

4. Aggiungere flussi di query a Excel

   In Excel, vai a Inserisci → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca AggiungiOppure aprilo direttamente da Query Streams su Microsoft AppSourceSul ripiano multifunzione compare il pulsante Query Streams. Accedi con lo stesso account.

   Funziona con Excel per Microsoft 365 su Windows e Mac, e con Excel sul web.

5. Porta il tuo primo tavolo

   Fai clic sul pulsante Query Streams, scegli Trasmetti una querye seleziona la connessione appena stabilita.

   Digita la query che vuoi eseguire. Questa estrae alcune colonne da un Stripe.fatture tavolo:

   Esempio · SQL

   SELECT number, status, amount_due / 100.0 AS amount_due, currency FROM stripe.invoices ORDER BY created DESC LIMIT 100;

   Sotto Scheda di destinazione scegliere Crea un nuovo foglioQuindi premi il pulsante di riproduzione (la freccia ▶). Le righe vengono importate in Excel in uno o due secondi. Premilo di nuovo ogni volta che i dati cambiano e il foglio si aggiornerà automaticamente.

   Non conosci SQL? Crea la query direttamente nel portale Query Streams. Generatore di query Mostra le tue tabelle e colonne in modo da poterle selezionare e cliccare. Con i piani Business puoi anche chiedere a Nova in linguaggio naturale ("mostrami i clienti negli Stati Uniti") e il sistema scriverà automaticamente la query SQL. Salva la query e sarà disponibile con un solo clic nel portale e nell'elenco delle query salvate del componente aggiuntivo, a partire dal piano Personal Core.

Buone mosse successive

• Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Excel o Fogli Google.
• Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
• Condividi i risultati con un collega. Loro vedono le righe, non le tue credenziali.

Domande che le persone si pongono

Guide correlate

• Stripe su Fogli Google
• Da HubSpot a Microsoft Excel
• Da Shopify a Microsoft Excel
• Da Google Analytics 4 a Microsoft Excel
• Esecuzione di query SQL in Excel
• Tutte le guide