Javascript API (nieuwe versie)

Overzicht

Met de Pandectes JavaScript API kun je programmatisch met de toestemmingsbanner communiceren vanuit het thema of je aangepaste scripts van je winkel. Zonder complexe code te schrijven, helpt het begrijpen van wat de API biedt je te weten wat mogelijk is en wanneer je een ontwikkelaar moet vragen dit voor je te implementeren.
Deze functie is beschikbaar op het New Banner en is toegankelijk via All settings > JavaScript API.

Wat kun je met de JavaScript API doen?

De huidige toestemmingsstatus van de bezoeker uitlezen

Met de API weet je winkel altijd, in realtime, waarmee een bezoeker heeft ingestemd. Je kunt controleren:

• Of een bezoeker analytics-tracking heeft toegestaan (bijv. Google Analytics, Microsoft Clarity)
• Of een bezoeker marketingcookies heeft toegestaan (bijv. Facebook Pixel, TikTok)
• Of een bezoeker voorkeurs- of functionaliteitscookies heeft toegestaan
• De volledige toestemmingsbeslissing van de bezoeker als één object

Dit is handig wanneer andere delen van je winkel zich anders moeten gedragen, afhankelijk van waarmee de bezoeker heeft ingestemd.

Het toestemmingsvenster beheren

Met de API kun je het toestemmingsvenster openen of sluiten vanuit elke actie in je winkel. Bijvoorbeeld een knop in de footer, een link op een privacybeleidspagina of een aangepaste optie "Cookie-instellingen" in je menu. Dit werkt naast de ingebouwde menulinkfunctie, maar geeft ontwikkelaars meer flexibiliteit om het vanaf elk element op de pagina te activeren.

Toestemming programmatisch instellen of bijwerken

In geavanceerde scenario's kan je winkel een toestemmingsbeslissing van een bezoeker direct instellen. Bijvoorbeeld wanneer een bezoeker een keuze maakt via een aangepaste interface die je zelf hebt gebouwd, of wanneer toestemming via een ander mechanisme is verzameld en aan Pandectes moet worden doorgegeven om toe te passen.

De taal van de banner wijzigen

Met de API kan de taal van het toestemmingsvenster dynamisch worden gewisseld. Als je winkel bezoekers in meerdere talen bedient en hun voorkeur detecteert, kan de banner in de juiste taal worden getoond, zonder alleen op de standaardinstelling van de browser te vertrouwen.

Reageren op toestemmingsevents

De API kan je winkel direct op de hoogte stellen wanneer er iets met toestemming gebeurt, zoals:

• Wanneer de banner volledig is geladen en klaar is
• Wanneer de bezoeker het toestemmingsvenster opent
• Wanneer het toestemmingsvenster wordt gesloten
• Wanneer de bezoeker zijn toestemmingsvoorkeuren wijzigt of bevestigt

Dit betekent dat je flows kunt bouwen die direct reageren op de keuze van een bezoeker. Bijvoorbeeld het laden van een trackingscript op het moment dat toestemming wordt gegeven, zonder de pagina te hoeven verversen.

Voor wie is dit bedoeld?

De JavaScript API is bedoeld voor verkopers met een ontwikkelaar of voor wie een aangepaste storefront gebruikt. Je hoeft de API niet te gebruiken of te begrijpen om de banner te laten werken. Die werkt volledig zelfstandig. Als je echter een diepere integratie wilt tussen de toestemmingsbanner en de rest van het gedrag van je winkel, is de API het juiste hulpmiddel.

Aan de slag

Om de API te verkennen en de volledige referentie te bekijken, ga je naar All settings > JavaScript API in de Pandectes-app. De pagina bevat de volledige lijst met beschikbare eigenschappen, functies en events, met beschrijvingen. Als je hulp nodig hebt bij het implementeren van een specifieke use case, neem dan gerust contact op met ons supportteam.

Bijgewerkt op: 27/10/2026