# WooCommerce koppelen aan RUIT

Tutorial om WooCommerce te koppelen: vul het adres van je winkel in en keur de toegang goed in WordPress, of maak API-sleutels aan en plak ze in RUIT.

_Updated: 2026-09-28 · Source: https://ruit.es/nl/docs/woocommerce-koppelen/_

In deze tutorial koppel je je WooCommerce-winkel aan RUIT. Er zijn twee wegen en ze komen allebei op
hetzelfde uit: **toestemming geven vanuit je eigen winkel**, de korte weg (je vult het adres in,
keurt goed in je WordPress en komt terug), of **sleutels plakken** die je zelf in WooCommerce
aanmaakt. Het duurt **vijf minuten** en je doet het **maar één keer**.

**Je hebt nodig** beheerdersrechten in de winkel, WooCommerce **3.5 of hoger** en een winkel die via
`https://` bereikbaar is, **in de hoofdmap van zijn domein**, zoals `https://jouwwinkel.nl`. En een
[geverifieerde telefoon](https://ruit.es/nl/docs/je-telefoon-verifieren/), want zonder die verificatie gaat het
venster om een account te koppelen niet open.

> **Waarschuwing:** RUIT houdt van het adres dat je invult alleen het domein over. Een WordPress die in een map staat,
> zoals `https://mijndomein.nl/winkel/`, raakt die map onderweg kwijt en kan op dit moment niet
> gekoppeld worden.

## 1. Vul in RUIT het adres van je winkel in

Ga naar **Instellingen → Accounts**, druk op **Account koppelen** en kies **WooCommerce**. Vul het
adres van je winkel in bij **Website**.

_Schermafbeelding: Het venster om WooCommerce te koppelen in RUIT: de vraag om de vereiste gegevens in te vullen, de link naar deze handleiding, het veld Website, de knop om te koppelen en daaronder het uitklapmenu om handmatig te koppelen_

Het WooCommerce-venster. Het nummer wijst **Website** aan. Onder de knop klapt **Liever handmatig
koppelen?** de weg met de sleutels open, en dat is stap 4.

## 2. Keur de toegang goed in je winkel

Druk op **Koppelen aan WooCommerce**. Zolang het adres leeg is, staat er op de knop **Verplichte
velden invullen**; staat het adres erin, dan brengt de knop je naar het autorisatiescherm van je
eigen winkel. Ben je niet als beheerder ingelogd, dan vraagt WordPress je eerst in te loggen.

Het scherm zegt wat RUIT aanvraagt: **lezen en schrijven** in je winkel, en dat heeft RUIT nodig om
producten te publiceren, de voorraad bij te houden en van verkopen te horen. Druk op **Goedkeuren**.

_Schermafbeelding: De autorisatiepagina van de WooCommerce-winkel: de melding dat RUIT verbinding wil maken met lees- en schrijftoegang, de lijst van wat het zal kunnen doen, het beheerdersaccount waarmee je ingelogd bent en de knoppen om te weigeren en goed te keuren_

De autorisatie, bekeken in een winkel met het beheerpaneel in het Engels. Het kader wijst
**Goedkeuren** aan; in jouw winkel staan de teksten in de taal van je WordPress.

> **Waarschuwing:** Deze autorisatie verloopt **15 minuten** nadat je op de knop hebt gedrukt. Laat je haar halverwege
> liggen, ga dan terug naar stap 1 en begin opnieuw.

## 3. Ga terug naar RUIT

Je winkel maakt twee sleutels aan en stuurt ze zelf naar RUIT; RUIT test ze bij je winkel, slaat
het account op en toont **WooCommerce gekoppeld**. Druk op **Mijn accounts bekijken** en ga door
naar «Wat je hebt bereikt».

## 4. Of plak de sleutels met de hand

Kun je in je winkel niet goedkeuren, of maak je de sleutel liever zelf aan, dan is de andere weg een
set API-sleutels van WooCommerce. Die maak je aan in je WordPress, bij **WooCommerce → Instellingen
→ Geavanceerd → REST API**, met de knop **Sleutel toevoegen**.

_Schermafbeelding: Het tabblad Geavanceerd van de instellingen van WooCommerce, bij het onderdeel REST API, met de lijst van bestaande sleutels en naast de titel de knop om een sleutel toe te voegen_

De lijst met sleutels van je winkel, met het beheerpaneel in het Engels. Het kader wijst **Sleutel
toevoegen** aan.

Geef de sleutel een beschrijving die je herkent, kies als gebruiker een **beheerder** en bij de
rechten **Lezen/schrijven**. Druk op **API-sleutel genereren**.

_Schermafbeelding: Het formulier voor de nieuwe sleutel in WooCommerce: het veld voor de beschrijving, de keuzelijst voor de gebruiker, de keuzelijst voor de rechten met Lezen/schrijven gekozen en de knop om de sleutel te genereren_

De drie kaders: de **beschrijving**, de **rechten** op lezen en schrijven, en de knop om te
**genereren**. De gebruiker is afgedekt omdat daar het e-mailadres van de beheerder staat.

> **Waarschuwing:** Maak de sleutel aan met **Lezen/schrijven**. RUIT controleert de rechten niet bij het koppelen: met
> een sleutel die alleen mag lezen lukt de koppeling gewoon, en het zijn de meldingen die je winkel bij
> elke verkoop naar RUIT stuurt die daarna mislukken, zonder dat je er iets van merkt.

WooCommerce toont de twee sleutels **maar één keer**: de **Klant sleutel**, die met `ck_` begint, en
het **Klantgeheim**, dat met `cs_` begint. Kopieer ze nu; sluit je de pagina, dan moet je een nieuwe
sleutel genereren.

_Schermafbeelding: De pagina van WooCommerce na het genereren van de sleutel: de melding om de sleutels nu te kopiëren, de velden Klant sleutel en Klantgeheim met elk een knop om te kopiëren, en de QR-code_

De twee sleutels, hier afgedekt. De kaders wijzen de twee knoppen om te **kopiëren** aan; de groene
melding waarschuwt dat het geheim niet opnieuw getoond wordt.

Ga terug naar RUIT, klap **Liever handmatig koppelen?** open en vul **Website**,
**Consumentensleutel** en **Consumentengeheim** in. Druk op **Koppelen**. RUIT controleert of de
sleutels de juiste vorm hebben en test ze daarna bij je winkel.

## Wat je hebt bereikt

Je winkel staat bij **Gekoppelde accounts**, met een eigen WooCommerce-kaart. De sleutels verlopen
niet, dus de kaart heeft niet de knop **Opnieuw koppelen** die Wallapop en Vinted wel hebben: de
koppeling blijft bestaan tot je de sleutel in WooCommerce verwijdert. Bovendien is je winkel nu zo
ingesteld dat hij RUIT elke verkoop meteen doorgeeft, zonder te wachten tot RUIT zelf komt kijken.

_Schermafbeelding: Het scherm Gekoppelde accounts van RUIT met een kaart per marketplace, waaronder die van WooCommerce met de gekoppelde winkel, en rechtsboven de knop Account koppelen_

De WooCommerce-winkel tussen de gekoppelde accounts. De kaart toont de naam die je het account
geeft, en geen knop om opnieuw te koppelen.

**Volgende stap:** importeren vanaf een marketplace om de producten op te halen die al in je winkel
staan, of [je eerste advertentie](https://ruit.es/nl/docs/je-eerste-advertentie/).

## Als iets niet klopt

- **«Verifiëren van de inloggegevens is mislukt. Controleer je API-sleutels en winkel-URL».** RUIT
  heeft je winkel aangeroepen en geen geldig antwoord gekregen. Die melding is voor alle oorzaken
  dezelfde, dus loop ze op volgorde na: het adres wijst naar de hoofdmap van het domein; de API van
  WooCommerce antwoordt op `https://jouwwinkel.nl/wp-json/wc/v3/` (een plugin voor beveiliging of de
  permalinks van WordPress op **Eenvoudig** schakelen haar uit); WooCommerce is 3.5 of hoger; en de
  sleutels zijn volledig gekopieerd.
- **«Ongeldige indeling van de inloggegevens».** De sleutel begint niet met `ck_` of het geheim
  begint niet met `cs_`. Kopieer ze allebei opnieuw, zonder spaties.
- **«De URL moet HTTPS gebruiken (niet HTTP)».** RUIT koppelt geen winkels zonder `https://`. Zet
  een certificaat op de winkel en probeer het opnieuw.
- **Je komt terug met «WooCommerce gekoppeld», maar de kaart staat niet bij Accounts.** Je winkel
  heeft goedgekeurd, maar RUIT kon de sleutels niet bij de winkel testen. Probeer de weg met de
  sleutels, stap 4, die je meteen vertelt wat er misgaat.
- **«De koppeling is niet geautoriseerd».** Je hebt in je winkel op **Weigeren** gedrukt. Herhaal
  alles vanaf stap 2 en accepteer de rechten die gevraagd worden.
- **De autorisatie stond langer dan 15 minuten open.** Ze is verlopen. Begin opnieuw bij stap 1.

- [Verkopen op WooCommerce met RUIT](https://ruit.es/nl/docs/marketplaces/)
- [PrestaShop koppelen aan RUIT](https://ruit.es/nl/docs/prestashop-koppelen/)
- [Hoe het koppelen van een account werkt](https://ruit.es/nl/docs/hoe-het-koppelen-van-een-account-werkt/)