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
- Log in bij Squarespace en open de site met je winkel.
- 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.
- Maak een nieuwe sleutel aan (Generate Key) en geef hem een herkenbare naam, bijvoorbeeld Winstwaker.
- Zet de rechten voor Orders en voor Transacties op alleen lezen (Read Only). Andere rechten zijn niet nodig.
- 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
- Log in op het Winstwaker-portaal.
- Ga naar Integraties en open de kaart Squarespace.
- Klik op Verbinden en plak de sleutel in het veld voor de API-sleutel.
- Klik op Test verbinding. Winstwaker controleert dan of de sleutel werkt.
- Klopt alles, klik dan op Verbinding opslaan. De sleutel wordt versleuteld bewaard.

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.