Hoe maak je client credentials voor de bol.com Retailer API aan?

Wat client credentials zijn

Client credentials zijn volgens bol een soort gebruikersnaam en wachtwoord voor de Retailer API. Een set bestaat uit een client id en een client secret. Een programma dat beide heeft, kan via de API bij je verkoopaccount: je bestellingen, je aanbod en meer. Zo werken tools die je bestellingen ophalen, je voorraad bijwerken of, zoals BluePing, je bestellingen in Slack zetten. Welke soorten tools er zijn, lees je in de manieren om een melding van een bestelling te krijgen.

Bol beschrijft het aanmaken in Toegang krijgen met API Client credentials. De stappen hieronder volgen die pagina, zoals hij er op 19 oktober 2026 uitzag. De Engelse versie heet Getting access with API Client credentials en heeft dezelfde stappen.

Noemt een tool het API Keys, dan bedoelt hij hetzelfde. Dat was de oude naam bij bol.

De stappen

1. Open de API-instellingen. Log in op je bol.com-verkoopaccount, open de instellingen en ga onder Diensten naar API Instellingen.
2. Vul je technisch contactpersoon in. Gebruik de gegevens van wie technisch verantwoordelijk is voor de koppeling, en klik op Opslaan. Zonder eigen ontwikkelaar ben je dat waarschijnlijk zelf.
3. Maak de set aan. Klik onder Client credentials voor de Retailer API op Aanmaken. Geef de set de naam van de tool die hem gaat gebruiken, bijvoorbeeld BluePing, en klik nog een keer op Aanmaken.
4. Bekijk de client id en het secret. De client id staat meteen in beeld. Klik op Toon secret, dan opent een venster met het client secret.
5. Vul ze in bij je tool. Plak de client id en het client secret in het programma dat de koppeling maakt.

Koppel je met BluePing, ga dan verder bij stap 4 van de installatiegids. BluePing controleert de set meteen bij bol, dus je ziet direct of hij werkt.

Let op de technisch contactpersoon

Op het Partnerplatform staat dat bol deze contactgegevens gebruikt om je te informeren over belangrijke updates en nieuws over de API. De ontwikkelaarsdocumentatie van bol is strenger. Zonder contactgegevens krijg je geen toegang tot de API, en met onjuiste gegevens riskeer je een blokkade als bol je niet kan bereiken.

Vul dus echte gegevens in en houd ze bij. Wisselt de persoon die de koppeling beheert, pas het contact dan ook aan.

Eén set per tool

Gebruik je meer dan één tool, maak dan voor elke tool een eigen set. Bol vraagt dat zelf op de hulppagina. In de documentatie over toegang staat ook dat je dezelfde set niet aan anderen geeft.

Het voordeel merk je als je stopt met een tool. Je verwijdert dan alleen zijn set en de andere tools blijven werken. Geef elke set de naam van de tool, dan weet je later welke set bij wie hoort.

Heb je meer dan één winkel, dan maak je in elk verkoopaccount een eigen set. In BluePing koppel je 1 winkel op Starter en tot 3 op Plus; elke winkel krijgt zijn eigen set. De plannen staan bij Prijzen.

Toegang intrekken

In API Instellingen staat achter elke set een prullenbakje. Verwijder je een set, dan werkt hij direct niet meer en verliest de tool zijn toegang. Wil je weer toegang geven, dan maak je een nieuwe set aan. Zo staat het in de documentatie over toegang.

Is een secret uitgelekt, of weet je niet meer bij welke tool een set hoort, maak dan een nieuwe set aan en verwijder de oude. Vul de nieuwe gegevens daarna in bij de tool die de oude gebruikte.

Sommige vertrouwde partners van bol hebben geen client credentials nodig. Je logt dan via hun site in bij bol en geeft één keer per jaar toestemming. Zo’n partner staat in API Instellingen onder Authorized parties, en daar verwijder je hem ook weer.

Wat een tool met je set kan

Bij credentials die je zelf aanmaakt, noemt bol geen keuze per onderdeel. Rechten per onderdeel, zoals alleen lezen of ook beheren, bestaan bij bol voor vermelde integratiepartners, volgens Fine grained access. Geef je set dus alleen aan een tool die je vertrouwt.

BluePing gebruikt je set alleen om te lezen: je bestellingen en je aanbod, voor de voorraadmelding. Het verandert niets in je verkoopaccount. Je client id en secret worden versleuteld opgeslagen. Van je bestellingen bewaart BluePing alleen een beknopte bestelsamenvatting, geen klantnamen, adressen of betaalgegevens. Meer over wat de API je biedt, lees je in wat de bol.com Retailer API is.