Comment connecter Stripe à Google Sheets - Interroger les données de paiement avec SQL

Connexion · Stripe à Google Sheets

Récupérer des données à partir de Rayure dans Google Sheets

Importez en temps réel les données de votre compte Stripe dans Google Sheets et actualisez-les à votre guise. Aucun import CSV, aucun script Apps Script, aucun copier-coller. Une dizaine de minutes suffisent la première fois, et le forfait gratuit couvre tout.

Environ 10 minutes Aucun codage nécessaire Vos identifiants vous suivent. N'importe quel navigateur, n'importe quel appareil

Ce que vous obtiendrez

Une feuille Google Sheets affichant les résultats en temps réel d'une requête SQL sur votre compte Stripe, avec un bouton permettant d'afficher les dernières lignes dès que les données changent. Par exemple :

Ventes Enregistré sur Drive

DéposerModifierVoirInsérerFormatDonnéesOutilsExtensionsAide

	A	B	C	D	E
1	numéro de client	prénom	nom de famille	pays	total
2	1042	Marie	Alvarez	USA	1,284.50
3	1043	Daniel	Okafor	USA	612.00
4	1047	Priya	Nair	USA	2,090.75
5	1051	Thomas	Berg	USA	338.20
6	1056	Lucía	Ferreira	USA	1,455.00
7	1060	Kenji	Sato	USA	874.10
8

+ clients Feuille1 En direct de Stripe

Stripe stocke vos données via son API. Pour les importer dans Google Sheets, il faut généralement exporter un fichier CSV depuis le tableau de bord Stripe à chaque fois que vous avez besoin de nouvelles données. Query Streams simplifie cette étape : un petit programme auxiliaire, appelé Agent, exécute la requête à l'endroit où se trouvent vos données, et une extension Google Sheets lui demande les lignes souhaitées. Seuls les résultats sont transférés, via une connexion chiffrée, et Google Sheets est accessible partout : depuis n'importe quel navigateur et sur n'importe quel appareil.

Ce dont vous aurez besoin

Un compte Query Streams

Le forfait gratuit suffit pour ce guide. Inscrivez-vous sur mon.querystreams.com.

L'agent sur n'importe quel ordinateur toujours allumé

Un petit programme qui s'exécute en arrière-plan et appelle Stripe lorsque Google Sheets le demande. Il nécessite simplement une connexion internet.

Votre identifiant Stripe

Vous vous connecterez à Stripe une seule fois et autoriserez l'accès en lecture. Aucun mot de passe n'est saisi dans les flux de requêtes.

Connectez-le en cinq étapes

1. Créez votre compte

   Aller à mon.querystreams.com et inscrivez-vous. Choisissez le Gratuit Ce forfait est définitif, il ne s'agit pas d'une version d'essai, et il inclut la connexion de votre compte Stripe et l'exécution de requêtes depuis Google Sheets.

2. Installez l'agent sur n'importe quel ordinateur toujours allumé.

   Connectez-vous, ouvrez TéléchargerInstallez ensuite l'agent sur n'importe quel ordinateur ou serveur toujours allumé et disposant d'un accès Internet. L'installation ne prend qu'une minute et l'agent s'exécute ensuite automatiquement.

   Pourquoi un petit programme plutôt qu'un pilote ? L'Agent est une installation unique pour Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux) qui fonctionne discrètement en arrière-plan. Il établit une connexion sortante chiffrée avec Query Streams, comme le ferait un navigateur ; vous n'avez donc pas besoin d'ouvrir de port dans votre pare-feu ni de configurer de VPN. Vos clés restent sur votre machine et les données sont transmises où que vous soyez, via Internet si nécessaire. Le seul élément requis de votre côté est l'extension.

   La page de téléchargement affiche Votre clé d'accèsCollez-le dans l'Agent lorsqu'il vous le demande, et attendez que le badge affiche Connecté aux flux de requêtesC'est la seule chose que vous devez faire sur l'Agent lui-même.

   Des guides complets sont disponibles si vous le souhaitez : Fenêtres, Mac, Linux.

3. Indiquez-lui l'adresse de votre compte Stripe.

   De retour dans votre navigateur, ouvrez Agents de données (sous Données (dans le menu du haut). Votre agent y est répertorié. Cliquez Ajouter un connecteur et choisissez RayureVous devez d'abord saisir vos identifiants Stripe ? Ouvrez le guide, puis remplissez les champs :

   Créez vos identifiants Stripe (environ 8 minutes)

   Ouvrez ensuite Stripe dans un autre onglet. Query Streams conserve les données que vous créez ici afin que votre agent puisse les utiliser, et ne lit que les données provenant de Stripe.

   Qui peut faire ça ?

   Propriétaire du compte, Super administrateur, Administrateur ou Développeur (les rôles Stripe qui peuvent créer des clés API)

   Recommandé

   Clé API restreinte avec autorisations en lecture seule (rk_live_… pour les données en direct, rk_test_… pour un environnement de test)

   Avant de commencer

   • Une connexion Stripe avec le rôle de propriétaire du compte, super administrateur, administrateur ou développeur est requise. Les autres rôles (analyste, lecture seule, support, etc.) ne peuvent pas créer de clés API.
   • Stripe vous donne accès à votre boîte mail ou à votre numéro de téléphone. Stripe demande un code avant de créer la clé.
   • L'assistant Query Streams s'ouvre dans un autre onglet (Agents de données → Ajouter un connecteur → Stripe) avec votre agent en ligne, vous pouvez donc coller la clé dès que Stripe l'affiche.

   Mesures

   1. Connectez-vous et choisissez des données réelles ou un environnement de test.

      Connectez-vous au tableau de bord Stripe. Stripe sépare les données de production et les données de test (sandbox), chacune ayant sa propre clé d'accès. Pour vos paiements réels, utilisez votre compte professionnel et non un environnement de test. Pour les données de test, ouvrez le sélecteur de compte du tableau de bord, cliquez sur « Environnements de test » et sélectionnez l'environnement de test souhaité.

      Une clé de production ne peut pas lire les données de test, et une clé de test ne peut pas lire les données de production. Si vous souhaitez accéder aux deux, créez une clé dans chaque environnement et ajoutez chacune d'elles comme connecteur Stripe distinct dans Query Streams.

   2. Ouvrez la page des clés API

      Ouvrez la page des clés API. Depuis le tableau de bord, vous pouvez également cliquer sur Développeurs (en bas à gauche) et sélectionner Clés API. La page comporte deux listes : Clés standard (clés publiques et clés secrètes) et Clés restreintes.

      Vous utilisez un environnement de test ? Ouvrez-le d’abord (étape 1). Chaque environnement de test possède sa propre page de clés API et ses propres clés.

   3. Démarrer une clé restreinte

      Dans la liste des clés restreintes, cliquez sur Créer une clé restreinte. Sur certains comptes, l'option s'affiche sous la forme + Créer une clé restreinte.

      N'utilisez pas la clé publique (pk_…). Elle ne permet pas de lire les données du compte. Une clé secrète (sk_…) fonctionne également avec Query Streams, mais elle permet d'effectuer toutes les opérations sur votre compte, y compris les remboursements et les paiements. Stripe recommande l'utilisation de clés restreintes, car Query Streams n'a besoin que d'accéder aux données en lecture.

   4. Indiquez comment la clé sera utilisée.

      Stripe vous demande comment vous allez utiliser la clé. Choisissez « Créer votre propre intégration », puis cliquez sur « Continuer ».

      Ne sélectionnez pas « Autoriser l'accès des agents à votre compte ». Cette option attribue la clé aux agents IA et ajoute les règles d'approbation de Stripe. Si vous avez sélectionné par erreur « Fournir cette clé à un autre site web », cochez « Personnaliser les autorisations de cette clé » sur l'écran suivant. Si vous ne cochez pas cette option, Stripe attribue à la clé ses autorisations par défaut au lieu de la liste en lecture seule de l'étape 7.

   5. Démarrer sans aucune autorisation

      Stripe propose des modèles d'autorisations prédéfinis ou la possibilité de partir de zéro. Choisissez cette dernière option (sélectionnez vos propres autorisations) : chaque autorisation sera alors initialisée à « Aucune ».

      Stripe modifie fréquemment le texte de cet écran. Recherchez une option du type « Démarrer à partir de zéro » ou « Choisir mon propre modèle ». Si vous ne trouvez pas cet écran, passez directement à l'étape 6.

   6. Nommez la clé

      Dans Nom de la clé, saisissez un nom que vous reconnaîtrez plus tard, par exemple Flux de requêtes (lecture seule).

   7. Configurer la lecture sur les 13 ressources. Synchronisation des flux de requêtes.

      Chaque ligne de ressource propose trois options : Aucune, Lecture et Écriture. Sélectionnez Lecture pour ces 13 lignes et laissez l’option Aucune pour toutes les autres. Sous « Core » : Solde, Sources de transactions du solde, Frais et remboursements, Clients, Litiges, Événements, Intentions de paiement, Versements, Produits. Sous « Facturation » : Coupons, Factures, Prix, Abonnements. Pour trouver rapidement une ligne, appuyez sur Ctrl+F (Cmd+F sur Mac) et saisissez le premier mot de son nom.

      Ne choisissez jamais « Écriture ». Query Streams ne fait que lire ; une clé avec l'autorisation « Lecture » ne peut donc pas créer de frais, de remboursements ni de paiements, même en cas de fuite de données. L'accès aux événements est nécessaire même si vous ne synchronisez jamais la table des événements, car Query Streams lit la liste des événements de Stripe pour détecter les modifications entre les synchronisations. Si vous utilisez Connect, laissez les autorisations du compte connecté sur « Aucune ». Si le nom d'une ligne ne correspond pas à ce que vous voyez, cliquez plutôt sur « Lecture » pour les en-têtes « Toutes les ressources principales » et « Toutes les ressources de facturation ». La clé reste en lecture seule, mais elle peut lire davantage de données que celles utilisées par Query Streams.

   8. Créez la clé

      Cliquez sur Créer une clé.

   9. Saisissez le code de vérification

      Stripe vous envoie un code de vérification par e-mail ou SMS. Saisissez-le dans la fenêtre qui s'affiche. Si la fenêtre ne se ferme pas automatiquement, cliquez sur Continuer.

      Pas de code ? Vérifiez vos spams ou le numéro de téléphone associé à votre profil Stripe.

   10. Copiez la clé

       Stripe affiche désormais la nouvelle clé. Elle commence par rk_live_ (ou rk_test_ dans un environnement de test). Cliquez sur la valeur de la clé pour la copier, puis collez-la directement dans le champ « Clé secrète Stripe » de l’assistant « Flux de requêtes ».

       En mode production, Stripe affiche la clé que vous avez créée une seule fois et ne peut plus la révéler. Les clés de l'environnement de test peuvent être révélées à tout moment. Ne transmettez pas la clé par e-mail ni par messagerie instantanée. Query Streams la stocke pour votre agent et ne l'utilise que pour la lecture.

   11. Notez où la clé est utilisée

       Dans « Ajouter une note », indiquez où la clé est utilisée, par exemple « Agent Query Streams sur l’ordinateur du bureau ». Cliquez ensuite sur « Terminé ». La clé apparaît alors dans la liste des clés restreintes.

       Cette notification apparaît chaque fois que vous ou un collègue consultez vos clés ultérieurement, afin que personne ne l'expire par accident.

   Autorisations à accorder

   Ressource	Accès	Utilisé pour
   Clients	Lire	Tableau des clients. La connexion de test est également consultée en premier.
   Frais et remboursements	Lire	Tableaux des frais et des remboursements. Une seule ligne regroupe les deux, et il n'y a pas de ligne distincte pour les remboursements.
   Intentions de paiement	Lire	tableau payment_intents
   Factures	Lire	Tables invoices et invoice_items. Les éléments de facture n'ont pas de ligne propre.
   Abonnements	Lire	tables subscriptions et subscription_items
   Solde	Lire	Tableau balance_transactions (Liste des transactions de solde de Stripe, anciennement appelée Historique du solde)
   Sources de transactions de solde	Lire	Table balance_transactions : permet de lier chaque transaction à la dépense, au remboursement ou au versement correspondant. Stripe précise que cela autorise également la lecture des soldes et des versements.
   Paiements	Lire	tableau des gains
   Litiges	Lire	table des litiges
   Produits	Lire	tableau des produits
   Prix	Lire	tableau des prix
   Coupons	Lire	tableau des coupons
   Événements	Lire	La table des événements et le flux de modifications qui permettent de maintenir à jour les clients, les abonnements, les factures, les éléments de facture, les frais, les intentions de paiement, les remboursements, les litiges, les versements, les produits, les prix et les coupons entre les synchronisations.

   Coller dans les flux de requêtes

   Clé secrète Stripe

   La clé restreinte que vous avez copiée à l'étape 10 (commence par rk_live_ ou rk_test_). Une clé secrète (sk_live_ ou sk_test_) fonctionne également, mais elle permet bien plus que la simple lecture.

   Problèmes courants

   La connexion de test a échoué en raison d'une clé API invalide.

   Pourquoi: Une partie de la clé a été omise lors de la copie, un espace a été ajouté, la clé publiable (pk_…) a été collée, ou quelqu'un a expiré ou fait tourner la clé dans Stripe.

   Réparer: La clé doit commencer par rk_ ou sk_. Collez-la à nouveau sans rien avant ni après. Si vous ne la possédez plus (Stripe n'affiche les clés actives qu'une seule fois), créez une nouvelle clé restreinte (étapes 3 à 11) et collez-la.

   Le test de connexion indique « Connecté », mais certaines tables restent vides et leur synchronisation affiche une erreur d'autorisation Stripe (403). Les agents plus récents affichent également un avertissement sous « Test de connexion » indiquant les tables auxquelles la clé ne peut pas accéder.

   Pourquoi: L'autorisation de lecture est manquante sur la ligne correspondante du tableau. Le message d'erreur de Stripe précise l'autorisation manquante ; par exemple, rak_event_read signifie « Événements ».

   Réparer: Sur la page des clés API Stripe, cliquez sur le menu ⋯ à côté de la clé, choisissez « Modifier la clé », définissez la ligne manquante sur « Lecture » et enregistrez. La clé elle-même reste inchangée ; vous n’avez donc rien à coller à nouveau. Cliquez de nouveau sur « Tester la connexion » dans « Flux de requêtes ».

   La connexion est établie, mais vous ne voyez que des données de test, ou les tableaux sont vides même si vous recevez de vrais paiements.

   Pourquoi: La clé provient d'un bac à sable (rk_test_) lorsque vous vouliez des données réelles, ou inversement.

   Réparer: Vérifiez le début de la clé. Pour les données réelles, utilisez le sélecteur de compte pour quitter l'environnement de test, recréez la clé (étapes 2 à 11), puis ouvrez le connecteur dans Agents de données, cliquez sur Modifier et collez-la dans Clé secrète Stripe. Conservez des connecteurs distincts pour les environnements de test et de production.

   Un connecteur qui fonctionnait auparavant ne se synchronise plus : « Clé API invalide ».

   Pourquoi: La clé Stripe a été renouvelée ou a expiré. Une clé renouvelée reste valide jusqu'à la date d'expiration choisie lors du renouvellement, soit 7 jours maximum.

   Réparer: Créez une nouvelle clé restreinte ou copiez la clé de remplacement depuis la rotation. Dans Query Streams, ouvrez le connecteur, cliquez sur Modifier, collez la clé dans le champ Clé secrète Stripe, cliquez sur Tester la connexion, puis sur Enregistrer.

   Vous ne voyez pas l'option « Créer une clé restreinte », ou la page des clés API ne s'ouvre pas.

   Pourquoi: Votre rôle Stripe ne vous permet pas de gérer les clés API. Les rôles Analyste, Lecture seule et Support ne le permettent pas non plus.

   Réparer: Demandez à votre responsable de compte Stripe, à un administrateur ou à un développeur de créer la clé pour vous, ou de modifier votre rôle.

   Stripe vous envoie un e-mail indiquant qu'il a bloqué une requête, et les synchronisations échouent même si la clé est correcte.

   Pourquoi: Une politique d'accès sur la clé (adresses IP ou avancée) n'autorise pas l'adresse Internet de l'ordinateur agent, ou bloque un VPN ou un proxy utilisé par l'ordinateur.

   Réparer: Sur la page des clés API, cliquez sur ⋯ à côté de la clé, choisissez Gérer la stratégie d'accès, puis sélectionnez une stratégie autorisant l'adresse IP publique de l'ordinateur agent ou choisissez Aucune. Cliquez ensuite sur Enregistrer.

   La clé a été divulguée (envoyée par e-mail ou messagerie instantanée, ou enregistrée dans un fichier partagé), ou une personne qui la détenait a quitté votre équipe.

   Pourquoi: Quiconque détient la clé peut lire tout ce que ses permissions autorisent.

   Réparer: Sur la page des clés API, cliquez sur les trois points à côté de la clé et choisissez « Renouveler la clé ». Dans « Expiration », sélectionnez « Maintenant » pour supprimer immédiatement l'ancienne clé, puis cliquez sur « Renouveler la clé API ». Copiez la nouvelle clé et collez-la dans le connecteur (Modifier → Clé secrète Stripe → Tester la connexion → Enregistrer).

   Vous souhaitez que Query Streams cesse de lire ce compte Stripe.

   Pourquoi: La suppression du connecteur ne désactive pas la clé. Celle-ci reste valide dans Stripe jusqu'à son expiration.

   Réparer: Sur la page des clés API, cliquez sur ⋯ à côté de la clé, sélectionnez « Expirer la clé », puis cliquez à nouveau sur « Expirer la clé » pour confirmer. Supprimez ensuite le connecteur dans Agents de données.

   Limites à connaître

   • Les événements sont conservés pendant 30 jours. La liste des événements de Stripe ne remonte qu'à 30 jours, la table des événements ne contient donc jamais plus de 30 jours. Query Streams analyse également les événements pour détecter les modifications entre les synchronisations. Ainsi, si un connecteur est désactivé pendant plus de quatre semaines environ, sa prochaine synchronisation relira intégralement ses tables.
   • Vitesse des requêtes : Stripe autorise 100 requêtes API par seconde en production et 25 en environnement de test (sandbox), la plupart des points de terminaison étant limités à 25. Chaque requête renvoie au maximum 100 enregistrements ; ainsi, une première synchronisation d’un million de transactions nécessite environ 10 000 requêtes, soit environ 7 minutes à raison de 25 requêtes par seconde. Les synchronisations en environnement de test sont plus lentes.
   • Nombre de lectures mensuelles : Stripe exige que le nombre moyen de requêtes de lecture par transaction sur un compte ne dépasse pas 500 sur une période de 30 jours glissants, avec un minimum de 10 000 par mois. Chaque table activée génère au moins une requête à chaque synchronisation. Par conséquent, sur un compte récent ou à faible volume d’activité, il est conseillé de définir des intervalles de synchronisation plus longs pour les tables dont la synchronisation n’est pas nécessaire à la minute près.
   • Un mode par clé : une clé ne lit que le mode dans lequel elle a été créée (live ou un sandbox particulier).
   • Connexion : la clé permet uniquement de lire les objets de votre propre compte. Les paiements sur les comptes connectés ne sont pas synchronisés.
   • Affichage de la clé : Stripe n’affiche qu’une seule fois une clé active créée, tandis que les clés de test peuvent être révélées à tout moment. Lorsqu’une clé est renouvelée, l’ancienne reste valide pendant 7 jours maximum.

   Étapes vérifiées le 8 octobre 2026. Sources : 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….

   Nom de la connexion

   Un nom que vous reconnaîtrez plus tard, comme base de données des ventes.

   Clé secrète Stripe

   Votre clé secrète Stripe se trouve dans le tableau de bord Stripe, sous Développeurs, Clés API ; elle commence par sk_live_ ou sk_test_.

   Cliquez sur Test de connexion.Quand il lit Connecté, cliquez ÉconomiserLa connexion atteint votre agent en quelques secondes.

   Agents de données ouvertes

   Test échoué ? Il s'agit généralement d'une autorisation manquante ou d'identifiants provenant d'un compte Stripe incorrect. La procédure détaillée ci-dessus répertorie les problèmes courants et leurs solutions.

4. Ajouter des flux de requêtes à Google Sheets

   Ouvrez n'importe quelle feuille Google, allez à Extensions → Modules complémentaires → Télécharger des modules complémentaires, Rechercher Flux de requêtes, et cliquez InstallerOu installez-le directement depuis Flux de requêtes sur la place de marché Google WorkspaceGoogle vous demandera d'autoriser l'extension ; c'est normal.

   Ensuite, dans chaque feuille Google que vous ouvrez, vous trouverez une icône Query Streams dans le panneau latéral droit, également répertoriée sous ExtensionsIl n'y a pas de connexion séparée. Le système reconnaît le compte Google que vous utilisez déjà ; l'adresse e-mail doit donc être celle associée à votre compte Query Streams.

5. Installez votre première table

   Cliquez sur l'icône Flux de requêtes dans le panneau latéral à droite de la feuille (ou trouvez-la sous Extensions). Choisir Flux de requêtes et sélectionnez la connexion que vous venez d'établir.

   Saisissez la requête que vous souhaitez exécuter. Celle-ci extrait quelques colonnes d'une base de données. factures Stripe tableau:

   Exemple · SQL

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

   Sous Fiche de destination Sélectionnez l'onglet dans lequel les lignes doivent apparaître, puis cliquez. Exécuter une requêteLes lignes s'affichent dans cet onglet en une ou deux secondes. Cliquez à nouveau sur « Exécuter la requête » dès que les données changent ; l'onglet se met alors à jour.

   Vous ne connaissez pas SQL ? Créez plutôt la requête dans le portail Query Streams. Générateur de requêtes L'interface affiche vos tables et colonnes, vous permettant de les parcourir par simple clic. Avec les abonnements Business, vous pouvez également interroger Nova en langage naturel (« Afficher les clients aux États-Unis ») et l'application génère automatiquement la requête SQL. Enregistrez-la : elle sera accessible en un clic depuis le portail et dans la liste des requêtes enregistrées de l'extension, à partir de l'abonnement Personal Core.

Bonnes prochaines étapes

• Enregistrer la requête dans le portail, vous pouvez donc le relancer en un seul clic, depuis Google Sheets ou Excel.
• Ajouter un filtre par exemple, une plage de dates, afin que la même requête puisse répondre « ce mois-ci » sans modification.
• Partagez les résultats avec un collègue. Il voit les rangs, pas vos qualifications.

Questions que se posent les gens

Guides associés

• Stripe vers Microsoft Excel
• HubSpot vers Google Sheets
• Shopify vers Google Sheets
• Vers Google Analytics 4 sur Google Sheets
• Power Query pour Google Sheets
• Tous les guides