Stripe koppelen aan Excel - Betalingsgegevens opvragen met SQL

Verbind Stripe met Excel

Gegevens ophalen van Streep naar binnen Excel

Haal live rijen uit je Stripe-account naar Excel en vernieuw ze wanneer je maar wilt. Geen ODBC-stuurprogramma, geen export, geen macro's. De eerste keer duurt het ongeveer tien minuten en het is inbegrepen bij het gratis abonnement.

Ongeveer 10 minuten Geen programmeerkennis vereist Uw inloggegevens blijven bij u. Excel overal, zelfs op het web.

Wat je uiteindelijk overhoudt

Een werkblad dat de live resultaten van een SQL-query op uw Stripe-account weergeeft, met een knop waarmee de meest recente rijen worden opgehaald zodra de gegevens wijzigen. Zoals dit:

Sales.xlsx — Excel

HomeInvoegenGegevensQuery-stromen

	A	B	C	D	E
1	klant_id	voornaam	achternaam	land	totaal
2	1042	Maria	Alvarez	VS	1,284.50
3	1043	Daniël	Okafor	VS	612.00
4	1047	Priya	Nair	VS	2,090.75
5	1051	Thomas	Berg	VS	338.20
6	1056	Lucía	Ferreira	VS	1,455.00
7	1060	Kenji	Sato	VS	874.10
8

Blad1 Live vanuit Stripe

Stripe bewaart je gegevens achter zijn API. Om ze in Excel te krijgen, moet je normaal gesproken elke keer dat je nieuwe cijfers nodig hebt een CSV-bestand exporteren vanuit het Stripe-dashboard. Query Streams maakt dit overbodig: een klein hulpprogramma, de Agent, voert de query uit op de locatie waar je gegevens zich bevinden, en een Excel-invoegtoepassing vraagt de Agent vervolgens om de gewenste rijen. Alleen de resultaten worden verzonden via een versleutelde verbinding, en Excel kan overal zijn: op je laptop thuis, op de computer van een collega aan de andere kant van het land, of via Excel op het web.

Wat je nodig hebt

Een Query Streams-account

Het gratis abonnement is voldoende voor deze handleiding. Meld je aan via mijn.querystreams.nl.

De Agent op elke computer die altijd aan staat.

Een klein programmaatje dat op de achtergrond draait en Stripe aanroept wanneer Excel daarom vraagt. Het enige wat het nodig heeft is een internetverbinding.

Je Stripe-login

Je hoeft je maar één keer aan te melden bij Stripe en leesrechten toe te staan. Er worden geen wachtwoorden ingevoerd in Query Streams.

Verbind het in vijf stappen.

1. Maak uw account aan

   Ga naar mijn.querystreams.nl en meld je aan. Kies de Gratis plan. Het is een echt plan, geen proefversie, en het omvat het koppelen van je Stripe-account en het uitvoeren van query's vanuit Excel.

2. Installeer de agent op een computer die altijd aan staat.

   Aanmelden, openen DownloadInstalleer de agent op een computer of server die altijd aan staat en internettoegang heeft. Dit duurt een minuut en daarna start de agent automatisch.

   Waarom een klein programma in plaats van een driver? De agent is een eenmalige installatie voor Windows, Mac of Linux (ongeveer 85 MB op Windows, iets meer dan 100 MB op Mac en Linux) die stil op de achtergrond draait. Het maakt één uitgaande, versleutelde verbinding met Query Streams, net zoals een browser dat doet, dus u hoeft geen firewallpoort te openen en geen VPN in te stellen. Uw sleutels blijven op die machine en de gegevens worden verzonden naar uw locatie, indien nodig via internet. Het enige dat u hoeft te doen, is de add-in installeren.

   De downloadpagina toont Uw toegangssleutelPlak het in de Agent wanneer daarom wordt gevraagd en wacht tot de badge is weergegeven. Verbonden met querystreamsDat is het enige wat je op de agent zelf doet.

   Complete walkthroughs zijn beschikbaar als je die wilt: Windows, Mac, Linux.

3. Koppel het aan je Stripe-account.

   Ga terug naar je browser en open... Data Agents (onder Gegevens (in het bovenste menu). Uw makelaar staat daar vermeld. Klik Connector toevoegen en kiezen StreepHeb je eerst je Stripe-inloggegevens nodig? Open dan de stappenplan en vul de volgende gegevens in:

   Maak je Stripe-inloggegevens aan. (ongeveer 8 minuten)

   Open Stripe vervolgens in een ander tabblad. Query Streams bewaart wat je hier aanmaakt, zodat je Agent het kan gebruiken, en leest alleen gegevens van Stripe.

   Wie kan dit doen?

   Accounteigenaar, Superbeheerder, Beheerder of Ontwikkelaar (de Stripe-rollen die API-sleutels kunnen aanmaken)

   Aanbevolen

   Beperkte API-sleutel met alleen-leestoegang (rk_live_… voor live data, rk_test_… voor een sandbox)

   Voordat je begint

   • Een Stripe-login met de rol van accounteigenaar, superbeheerder, beheerder of ontwikkelaar is vereist. Andere rollen (analist, alleen-lezen, ondersteuning, enzovoort) kunnen geen API-sleutels aanmaken.
   • Toegang tot de e-mailinbox of het telefoonnummer waarnaar Stripe verificatiecodes verstuurt. Stripe vraagt om een code voordat de sleutel wordt aangemaakt.
   • De wizard Query Streams wordt in een nieuw tabblad geopend (Data Agents → Connector toevoegen → Stripe) terwijl uw agent online is, zodat u de sleutel kunt plakken zodra Stripe deze weergeeft.

   Stappen

   1. Meld u aan en kies voor live data of een sandbox.

      Meld u aan bij het Stripe-dashboard. Stripe houdt live data en sandbox (test) data gescheiden, en elk heeft zijn eigen sleutels. Voor uw echte betalingen dient u ingelogd te blijven op uw zakelijke account, niet op een sandbox. Voor testdata opent u de accountkiezer in het dashboard, klikt u op Sandboxes en opent u de gewenste sandbox.

      Een live-sleutel kan geen sandbox-gegevens lezen en een sandbox-sleutel kan geen live-gegevens lezen. Als u beide wilt, maak dan voor elk type sleutel een aparte sleutel aan en voeg deze voor elk type toe als een eigen Stripe-connector in Query Streams.

   2. Open de pagina met API-sleutels

      Open de pagina met API-sleutels. Vanuit het dashboard kunt u ook op Ontwikkelaars (linksonder) klikken en API-sleutels kiezen. De pagina bevat twee lijsten: Standaardsleutels (publiceerbare en geheime sleutels) en Beperkte sleutels.

      Gebruik je een sandbox? Open dan eerst de sandbox (stap 1). Elke sandbox heeft een eigen pagina met API-sleutels en eigen sleutels.

   3. Start een beperkte sleutel

      Klik in de lijst met beperkte sleutels op 'Beperkte sleutel maken'. Bij sommige accounts wordt dit weergegeven als '+ Beperkte sleutel maken'.

      Gebruik de publiceerbare sleutel (pk_…) niet. Deze kan geen accountgegevens lezen. Een geheime sleutel (sk_…) werkt ook in Query Streams, maar deze kan alles in uw account doen, inclusief terugbetalingen en uitbetalingen. Stripe raadt beperkte sleutels aan, en Query Streams hoeft alleen maar te lezen.

   4. Leg uit hoe de sleutel gebruikt zal worden.

      Stripe vraagt hoe je de sleutel gaat gebruiken. Kies 'Je eigen integratie bouwen' en klik vervolgens op 'Doorgaan'.

      Kies niet voor 'Toegang van de agent tot uw account toestaan'. Deze optie markeert de sleutel voor AI-agenten en voegt de goedkeuringsregels van Stripe toe. Als u per ongeluk 'Deze sleutel aan een andere website verstrekken' hebt gekozen, vink dan 'Machtigingen voor deze sleutel aanpassen' aan op het volgende scherm. Als u dit niet aanvinkt, geeft Stripe de sleutel de standaardmachtigingen in plaats van de alleen-lezen-lijst in stap 7.

   5. Beginnen zonder machtigingen

      Stripe biedt kant-en-klare machtigingssjablonen of de mogelijkheid om helemaal vanaf nul te beginnen. Kies ervoor om helemaal vanaf nul te beginnen (selecteer je eigen machtigingen), zodat elke machtiging in eerste instantie op 'Geen' staat.

      Stripe wijzigt de tekst op dit scherm regelmatig. Zoek naar een optie met een tekst als 'Van nul af aan beginnen' of 'Mijn eigen optie kiezen', en niet naar een sjabloon. Als het scherm er niet is, ga dan direct naar stap 6.

   6. Geef de sleutel een naam.

      Typ bij Sleutelnaam een naam die u later gemakkelijk kunt herkennen, bijvoorbeeld Query Streams (alleen-lezen).

   7. Stel 'Lezen' in op de 13 bronnen. Query Streams synchroniseert.

      Elke rij met gegevens heeft drie opties: Geen, Lezen en Schrijven. Klik op Lezen voor deze 13 rijen en laat alle andere rijen op Geen staan. Onder Kern: Saldo, Transactiebronnen saldo, Kosten en terugbetalingen, Klanten, Geschillen, Evenementen, Betalingsintenties, Uitbetalingen, Producten. Onder Facturering: Coupons, Facturen, Prijzen, Abonnementen. Om snel een rij te vinden, drukt u op Ctrl+F (Cmd+F op een Mac) en typt u het eerste woord van de naam.

      Kies nooit voor Schrijven. Query Streams leest alleen, dus een sleutel met alleen Leesrechten kan geen kosten, terugbetalingen of uitbetalingen aanmaken, zelfs niet als er gegevens lekken. Je hebt Gebeurtenissen nodig, zelfs als je de gebeurtenistabel nooit synchroniseert, omdat Query Streams de gebeurtenislijst van Stripe leest om wijzigingen tussen synchronisaties op te pikken. Als je Connect gebruikt, laat je de machtigingen voor het verbonden account op Geen staan. Als een rijnaam niet overeenkomt met wat je ziet, klik je in plaats daarvan op Lezen bij de kopregels Alle kernbronnen en Alle factureringsbronnen. De sleutel is nog steeds alleen-lezen, maar kan meer lezen dan Query Streams gebruikt.

   8. Maak de sleutel aan

      Klik op Sleutel aanmaken.

   9. Voer de verificatiecode in.

      Stripe stuurt een verificatiecode per e-mail of sms. Voer deze code in het dialoogvenster in. Als het dialoogvenster niet vanzelf verdergaat, klik dan op Doorgaan.

      Geen code ontvangen? Controleer je spammap of het telefoonnummer in je Stripe-profiel.

   10. Kopieer de sleutel

       Stripe toont nu de nieuwe sleutel. Deze begint met rk_live_ (of rk_test_ in een sandbox). Klik op de sleutelwaarde om deze te kopiëren en plak deze vervolgens direct in het veld 'Stripe Secret Key' in de wizard 'Query Streams'.

       In de livemodus toont Stripe de sleutel die je hebt aangemaakt slechts één keer en kan deze niet opnieuw onthullen. Sandbox-sleutels kunnen op elk moment worden onthuld. Verstuur de sleutel niet via e-mail of chat. Query Streams bewaart de sleutel voor je agent en gebruikt deze alleen om gegevens te lezen.

   11. Let op waar de sleutel wordt gebruikt.

       Typ in het veld 'Een notitie toevoegen' waar de sleutel wordt gebruikt, bijvoorbeeld 'Query Streams Agent' op de kantoorcomputer. Klik vervolgens op 'Gereed'. De sleutel verschijnt nu in de lijst met beperkte sleutels.

       De melding verschijnt telkens wanneer jij of een collega later je sleutels controleert, zodat niemand deze per ongeluk laat verlopen.

   Toestemmingen verlenen

   Bron	Toegang	Gebruikt voor
   Klanten	Lezen	De tabel met klanten wordt ook eerst door de testverbinding gelezen.
   Kosten en terugbetalingen	Lezen	Tabellen voor kosten en terugbetalingen. Eén rij omvat beide, en er is geen aparte rij voor terugbetalingen.
   Betalingsintenties	Lezen	tabel met betalingsintenties
   Facturen	Lezen	De tabellen invoices en invoice_items hebben geen eigen rij.
   Abonnementen	Lezen	abonnementen en abonnementsitems tabellen
   Saldo	Lezen	tabel balance_transactions (Stripe's lijst met saldo-transacties, voorheen Balance history genoemd)
   Balans van transactiebronnen	Lezen	De tabel balance_transactions: hiermee kan elke transactie worden gekoppeld aan de bijbehorende afschrijving, terugbetaling of uitbetaling. Stripe geeft aan dat dit ook leesrechten geeft voor het saldo en de uitbetalingen.
   Uitbetalingen	Lezen	uitbetalingstabel
   Geschillen	Lezen	geschillentabel
   Producten	Lezen	producttabel
   Prijzen	Lezen	prijstabel
   Coupons	Lezen	coupons tabel
   Evenementen	Lezen	De tabel met gebeurtenissen en de wijzigingsfeed zorgen ervoor dat klanten, abonnementen, facturen, factuurregels, kosten, betalingsintenties, terugbetalingen, geschillen, uitbetalingen, producten, prijzen en kortingsbonnen tussen synchronisaties up-to-date blijven.

   Plakken in querystreams

   Stripe geheime sleutel

   De beperkte sleutel die je in stap 10 hebt gekopieerd (begint met rk_live_ of rk_test_). Een geheime sleutel (sk_live_ of sk_test_) werkt ook, maar die kan veel meer dan alleen lezen.

   Veelvoorkomende problemen

   De testverbinding mislukt met de melding 'Ongeldige API-sleutel'.

   Waarom: Een deel van de sleutel is weggevallen tijdens het kopiëren, er is een spatie toegevoegd, de publiceerbare sleutel (pk_…) is geplakt, of iemand heeft de sleutel bij Stripe laten verlopen of geroteerd.

   Repareren: De sleutel moet beginnen met rk_ of sk_. Plak hem opnieuw, zonder iets ervoor of erna. Als je de sleutel niet meer hebt (Stripe toont actieve sleutels slechts één keer), maak dan een nieuwe beperkte sleutel aan (stappen 3 tot en met 11) en plak die.

   De verbindingstest geeft aan dat de verbinding tot stand is gebracht, maar sommige tabellen blijven leeg en de synchronisatie ervan toont een Stripe-toestemmingsfout (403). Nieuwere agents tonen ook een waarschuwing onder 'Verbindingstest' met de namen van de tabellen die niet kunnen worden gelezen.

   Waarom: De sleutel 'Lezen' ontbreekt in de betreffende rij van de tabel. In de foutmelding van Stripe wordt de ontbrekende toestemming vermeld; bijvoorbeeld rak_event_read betekent 'Evenementen'.

   Repareren: Klik op de Stripe API-sleutelpagina op het menu ⋯ naast de sleutel, kies 'Sleutel bewerken', stel de ontbrekende rij in op 'Lezen' en sla op. De sleutel zelf verandert niet, dus u hoeft niets opnieuw te plakken. Klik nogmaals op 'Verbinding testen' in 'Query Streams'.

   Er is wel een verbinding, maar je ziet alleen testgegevens, of de tabellen zijn leeg, ook al ontvang je echte betalingen.

   Waarom: De sleutel komt uit een sandbox (rk_test_) wanneer je live data nodig hebt, of andersom.

   Repareren: Controleer hoe de sleutel begint. Voor live data gebruikt u de accountkiezer om de sandbox te verlaten, de sleutel opnieuw aan te maken (stappen 2 tot en met 11), vervolgens de connector in Data Agents te openen, op Bewerken te klikken en deze in het veld Stripe Secret Key te plakken. Houd test- en live-connectoren gescheiden.

   Een connector die voorheen wel werkte, synchroniseert niet meer met de melding 'Ongeldige API-sleutel'.

   Waarom: Iemand heeft de sleutel in Stripe geroteerd of laten verlopen. Een geroteerde sleutel blijft alleen werken tot de bij de rotatie gekozen vervaldatum, die maximaal 7 dagen is.

   Repareren: Maak een nieuwe beperkte sleutel aan of kopieer de vervangende sleutel uit de rotatie. Open in Query Streams de connector, klik op Bewerken, plak de sleutel in Stripe Secret Key, klik op Verbinding testen en vervolgens op Opslaan.

   Je ziet de optie 'Beperkte sleutel aanmaken' niet, of de pagina met API-sleutels wordt niet geopend.

   Waarom: Met jouw Stripe-rol kun je geen API-sleutels beheren. Dit geldt voor de rollen Analist, Alleen-lezen en Support.

   Repareren: Vraag de eigenaar van je Stripe-account, een beheerder of een ontwikkelaar om de sleutel voor je aan te maken of je rol te wijzigen.

   Stripe stuurt je een e-mail dat een verzoek is geblokkeerd en dat de synchronisatie mislukt, ook al is de sleutel correct.

   Waarom: Een toegangsbeleid op de sleutel (IP-adressen of Geavanceerd) staat het internetadres van de agentcomputer niet toe, of blokkeert een VPN of proxy die de computer gebruikt.

   Repareren: Klik op de pagina met API-sleutels op ⋯ naast de sleutel, kies 'Toegangsbeleid beheren' en selecteer een beleid dat het openbare IP-adres van de agentcomputer toestaat, of kies 'Geen'. Klik vervolgens op 'Opslaan'.

   De sleutel is openbaar geworden (via e-mail of chat, of opgeslagen in een gedeeld bestand), of iemand die de sleutel had, heeft je team verlaten.

   Waarom: Iedereen die de sleutel in handen heeft, kan alles lezen wat de bijbehorende machtigingen toestaan.

   Repareren: Klik op de pagina met API-sleutels op ⋯ naast de sleutel en kies 'Sleutel roteren'. Selecteer bij 'Vervaldatum' de optie 'Nu' om de oude sleutel direct te verwijderen en klik vervolgens op 'API-sleutel roteren'. Kopieer de nieuwe sleutel en plak deze in de connector (Bewerken → Stripe Secret Key → Verbinding testen → Opslaan).

   Je wilt dat Query Streams stopt met het lezen van dit Stripe-account.

   Waarom: Het verwijderen van de connector deactiveert de sleutel niet. Deze blijft geldig in Stripe totdat u deze laat verlopen.

   Repareren: Klik op de pagina met API-sleutels op ⋯ naast de sleutel, kies 'Sleutel laten verlopen' en klik nogmaals op 'Sleutel laten verlopen' om te bevestigen. Verwijder vervolgens de connector in Data Agents.

   Grenzen aan wat je kunt weten

   • Gebeurtenissen gaan 30 dagen terug. De gebeurtenissenlijst van Stripe gaat slechts 30 dagen terug, dus de gebeurtenissentabel bevat nooit meer dan de laatste 30 dagen. Query Streams leest ook gebeurtenissen om wijzigingen tussen synchronisaties op te pikken, dus als een connector langer dan ongeveer vier weken is uitgeschakeld, leest de volgende synchronisatie de tabellen weer volledig uit.
   • Aanvraagsnelheid: Stripe staat 100 API-aanvragen per seconde toe in de live-modus en 25 in een sandbox-omgeving. De meeste individuele endpoints staan 25 aanvragen per seconde toe. Elke aanvraag retourneert maximaal 100 records, dus een eerste synchronisatie van 1.000.000 transacties vereist ongeveer 10.000 aanvragen, wat ongeveer 7 minuten duurt bij een snelheid van 25 aanvragen per seconde. Synchronisaties in de sandbox-omgeving zijn trager.
   • Maandelijks leeslimiet: Stripe verwacht dat het gemiddelde aantal leesverzoeken per transactie van een account niet meer dan 500 bedraagt over een periode van 30 dagen, met een minimum van 10.000 per maand. Elke ingeschakelde tabel doet minstens één verzoek per synchronisatie. Stel daarom bij een nieuw account of een account met een laag transactievolume langere synchronisatie-intervallen in voor tabellen die u niet minuut voor minuut nodig hebt.
   • Eén modus per toets: een toets leest alleen de modus waarin deze is aangemaakt (live of een specifieke sandbox).
   • Verbinden: de sleutel leest alleen de objecten van uw eigen account. Betalingen op verbonden accounts worden niet gesynchroniseerd.
   • De sleutel opnieuw weergeven: Stripe toont een actieve sleutel die je hebt aangemaakt slechts één keer, terwijl sandbox-sleutels op elk moment zichtbaar kunnen zijn. Wanneer je een sleutel vervangt, blijft de oude sleutel maximaal 7 dagen geldig.

   Stappen geverifieerd op 8 oktober 2026. Bronnen: 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….

   Verbindingsnaam

   Elke naam die je later zult herkennen, zoals 'Verkoopdatabase'.

   Stripe geheime sleutel

   Je geheime Stripe-sleutel vind je in het Stripe-dashboard onder Ontwikkelaars, API-sleutels; deze begint met sk_live_ of sk_test_.

   Klik op TestverbindingWanneer er staat Aangesloten, klik SlaDe verbinding bereikt uw agent binnen enkele seconden.

   Open Data Agents

   Test mislukt? Meestal gaat het om een ontbrekende machtiging of inloggegevens van het verkeerde Stripe-account. De bovenstaande stappen beschrijven de oorzaak. veelvoorkomende problemen en de oplossingen daarvoor.

4. Querystreams toevoegen aan Excel

   Ga in Excel naar Invoegen → Invoegingen ophalen, zoeken naar Query-stromenen klik ToevoegenOf open het direct vanuit Querystreams op Microsoft AppSourceEr verschijnt een knop 'Query Streams' in het lint. Meld u aan met hetzelfde account.

   Werkt in Excel voor Microsoft 365 op Windows en Mac, en in Excel op het web.

5. Schuif je eerste tafel aan

   Klik op de knop Query Streams en kies Een query streamenen kies de verbinding die je zojuist hebt gemaakt.

   Typ de query die u wilt uitvoeren. Deze haalt een paar kolommen op uit een stripe.facturen tafel:

   Voorbeeld · SQL

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

   Onder Bestemmingsblad kiezen Maak een nieuw werkblad aanDruk vervolgens op de afspeelknop (de ▶-pijl). De rijen verschijnen binnen een seconde of twee in Excel. Druk er nogmaals op wanneer de gegevens zijn gewijzigd en het werkblad wordt direct bijgewerkt.

   Weet je niet wat SQL is? Stel de query samen in de Query Streams-portal. Querybouwer Het toont je tabellen en kolommen, zodat je ze kunt selecteren met een muisklik. Bij Business-abonnementen kun je Nova ook gewoon in het Engels vragen ("laat me klanten in de VS zien") en dan genereert het de SQL-query voor je. Sla de query op en je hebt hem met één klik in de portal en in de lijst met opgeslagen query's van de add-in (vanaf Personal Core).

Goede volgende stappen

• Sla de zoekopdracht op. In het portaal kunt u het vervolgens met één klik opnieuw uitvoeren, vanuit Excel of Google Sheets.
• Voeg een filter toe zoals een datumbereik, zodat dezelfde zoekopdracht "deze maand" kan antwoorden zonder aanpassingen.
• Deel de resultaten met een collega. Zij zien de rijen, niet je inloggegevens.

Vragen die mensen stellen

Gerelateerde handleidingen

• Stripe naar Google Spreadsheets
• HubSpot naar Microsoft Excel
• Shopify naar Microsoft Excel
• Google Analytics 4 naar Microsoft Excel
• SQL-query's uitvoeren in Excel
• Alle handleidingen