Kennisbank · Webshop

Squarespace koppelen aan je administratie.

Maak een API-sleutel met alleen leesrechten en controleer je eerste orders.

4 minuten lezen · Winstwaker redactie · Geplaatst 21 oktober 2026

Orders, kosten en uitbetaling hebben elk hun plek.

  1. Squarespace-orders
  2. Administratie
  3. Betaalprovider
  4. Bank

Verkoop je via een Squarespace-winkel? Dan haal je je orders via Integraties in het Winstwaker-portaal automatisch binnen. Je installeert geen app en keurt niets goed in een inlogscherm: je maakt in Squarespace zelf een API-sleutel aan met alleen leesrechten en plakt die in Winstwaker.

Wat de koppeling doet

Winstwaker leest je orders en transacties uit Squarespace en verwerkt ze in je administratie:

  • Orders: per order een verkoopfactuur, met klant, land en orderregels.
  • Btw per regel: het btw-tarief en het btw-bedrag komen per orderregel en per verzendregel uit Squarespace. Kortingen zijn al verrekend in de regelbedragen.
  • Terugbetalingen: een terugbetaling wordt een creditnota bij de oorspronkelijke order.
  • Betaalprovider: Winstwaker herkent of een order is betaald via Squarespace Payments, Stripe of PayPal en zet de betaling op de tussenrekening van die betaalprovider.
  • Verwerkingskosten: de transactiekosten die Squarespace per betaling doorgeeft komen mee, na eventueel teruggestorte kosten.

Winstwaker leest alleen. Er gaat niets terug naar je winkel.

Twijfelgevallen boekt Winstwaker niet automatisch, maar legt hij eerst ter controle voor. Denk aan donaties, een betaling met een cadeaubon, een order die met verschillende betaalproviders is betaald, een gedeeltelijke terugbetaling over meerdere btw-tarieven of bedragen die niet sluiten. Testorders worden als test herkend.

Wat je nodig hebt

  • Een Squarespace-site met een winkel en een abonnement waarmee je API-sleutels voor Orders en Transacties kunt aanmaken (zie hieronder)
  • Toegang tot de instellingen van je Squarespace-site
  • Toegang tot het Winstwaker-portaal

Welk Squarespace-abonnement heb je nodig?

Volgens Squarespace kun je een API-sleutel met rechten op Orders en Transacties aanmaken met een Core-, Plus- of Advanced-abonnement, of met het oudere Commerce Advanced. Met Basic, Personal of Business kan dat niet.

Squarespace past zijn abonnementen geregeld aan. Controleer het actuele overzicht daarom in het helpartikel van Squarespace over API-sleutels. Kun je met jouw abonnement geen sleutel met deze rechten aanmaken, dan werkt deze koppeling niet. Vraag je boekhouder dan hoe je je verkopen aanlevert.

Stap 1 — Maak een API-sleutel in Squarespace

  1. Log in bij Squarespace en open de site met je winkel.
  2. Ga naar Instellingen → Ontwikkelaarstools → Ontwikkelaars-API-sleutels. Bij sommige sites staat dit onder Instellingen → Geavanceerd. In de Engelstalige versie heet het Settings → Developer Tools → Developer API Keys.
  3. Maak een nieuwe sleutel aan (Generate Key) en geef hem een herkenbare naam, bijvoorbeeld Winstwaker.
  4. Zet de rechten voor Orders en voor Transacties op alleen lezen (Read Only). Andere rechten zijn niet nodig.
  5. Bevestig en kopieer de sleutel meteen. Squarespace toont hem maar één keer.

Kies een ontwikkelaars-API-sleutel en geen externe API-sleutel (External API Keys); die zijn voor iets anders bedoeld. Bewaar de sleutel niet in een e-mail of los bestand: je plakt hem zo in Winstwaker.

Stap 2 — Plak de sleutel in Winstwaker

  1. Log in op het Winstwaker-portaal.
  2. Ga naar Integraties en open de kaart Squarespace.
  3. Klik op Verbinden en plak de sleutel in het veld voor de API-sleutel.
  4. Klik op Test verbinding. Winstwaker controleert dan of de sleutel werkt.
  5. Klopt alles, klik dan op Verbinding opslaan. De sleutel wordt versleuteld bewaard.

Overzicht van integraties in Winstwaker

Volg de velden en knoppen in het portaal; die zijn leidend als een veld of knop anders heet.

Na het koppelen

Nieuwe en gewijzigde orders komen bij een volgende synchronisatie binnen. Controleer na de eerste keer een paar orders: kloppen het bedrag, het land van de klant en het btw-tarief? Wat Winstwaker ter controle heeft klaargezet, bekijk je samen met je boekhouder.

Squarespace Payments of Stripe?

Voor je klant maakt het weinig uit. Voor je boekhouding zit het verschil in hoe de uitbetaling op je bank aansluit.

  • Stripe: Squarespace geeft de order en de betaling door. Daarnaast kun je in Winstwaker Stripe zelf koppelen. Dan ziet Winstwaker per uitbetaling welke betalingen, kosten en terugbetalingen erin zitten, zodat iedere uitbetaling exact per order en met kosten wordt afgeletterd.
  • Squarespace Payments: orders en verwerkingskosten komen via Squarespace binnen. Komt er een uitbetaling van Squarespace op je bank, dan zoekt Winstwaker welke orders min kosten precies dat bedrag vormen en stelt die afletter voor; je boekhouder bevestigt hem met één klik. Een aparte uitbetalingsspecificatie, zoals bij een Stripe-koppeling, komt er via Squarespace niet bij. Zit er een terugbetaling in de uitbetaling of zijn het heel veel orders tegelijk, dan letter je hem samen met je boekhouder af.

Beide werken. Wil je de meest sluitende automatische aansluiting tussen order, kosten en bankstorting, dan geeft Stripe met een eigen Stripe-koppeling de meeste gegevens. Tarieven, uitbetalingsmomenten en voorwaarden verschillen per aanbieder en veranderen; vergelijk die bij Squarespace en Stripe zelf.

Tips

  • Koppel ook je bank, zodat uitbetalingen op je rekening tegen de juiste tussenrekening worden afgeletterd.
  • Squarespace geeft geen btw-nummer van je klant door. Verkoop je zakelijk aan klanten in een ander EU-land met verlegde btw, laat dat je boekhouder dan weten.
  • Gebruik je de koppeling niet meer, ontkoppel Squarespace dan in Integraties en trek de sleutel in Squarespace in. Maak je een nieuwe sleutel aan, plak die dan opnieuw in via Integraties.

Meer lezen

Praktische controle

De juiste sleutel, de juiste rechten.

  1. 01Abonnement
  2. 02Alleen lezen: Orders en Transacties
  3. 03Eerste orders

Controleer wat voor jouw situatie geldt.

Terug naar de inhoud ↑
Moet ik een app installeren of inloggen via Squarespace?

Nee. Je maakt in Squarespace zelf een ontwikkelaars-API-sleutel aan en plakt die in Winstwaker. Een app-installatie of een toestemmingsscherm (OAuth) is niet nodig.

Welke rechten heeft de API-sleutel nodig?

Alleen lezen op Orders en alleen lezen op Transacties. Andere rechten zijn niet nodig. Winstwaker schrijft niets terug naar je winkel.

Welk Squarespace-abonnement heb ik nodig?

Volgens Squarespace kun je API-sleutels voor Orders en Transacties aanmaken met Core, Plus, Advanced of het oudere Commerce Advanced, en niet met Basic, Personal of Business. Controleer het actuele overzicht bij Squarespace.

Wat gebeurt er met een terugbetaling?

Een terugbetaling wordt een creditnota bij de oorspronkelijke order. Valt een gedeeltelijke terugbetaling niet eenduidig over de btw-tarieven te verdelen, dan legt Winstwaker hem ter controle voor in plaats van te gokken.

Squarespace Payments of Stripe: wat is handiger voor mijn boekhouding?

Beide werken. Met Stripe kun je Stripe zelf ook koppelen, zodat iedere uitbetaling per order en met kosten aansluit. Bij Squarespace Payments komen orders en kosten via Squarespace binnen; Winstwaker stelt voor welke orders en kosten in een uitbetaling op je bank zitten, en je boekhouder bevestigt dat.

De test mislukt. Wat controleer ik eerst?

Of je de volledige sleutel hebt geplakt, of de sleutel leesrechten heeft op Orders én Transacties en of hij in Squarespace niet is ingetrokken. Volg daarna de foutmelding in het portaal.

Open de portaalhulp →

Verder met jouw situatie.

Lees de volgende stap of stel je vraag.