Documentatie

Van nul naar je eerste verkochte bon in vijf stappen — zonder developer.

1. 1

   Maak een account

   Registreer op Kadoobon en vul je zaaknaam, kleur en winkeltaal in. Je krijgt meteen een eigen winkelpagina op kadoobon.com/store/jouw-zaak.

2. 2

   Ontwerp je eerste bon

   Kies in het dashboard een thema (verjaardag, bedankje, kerst …) of je eigen huisstijl, en stel de bedragen in — vast of vrij te kiezen. Of maak een dienst-bon met een vaste prijs, zoals '1 uur massage'.

3. 3

   Test je winkel

   Zolang er geen betaalprovider gekoppeld is, staat je winkel in testmodus: je kan de hele flow proberen zonder dat er geld beweegt.

4. 4

   Verbind Mollie

   Plak je Mollie API-key in Instellingen → Payments. Vanaf dan zijn betalingen live en komt het geld rechtstreeks op jouw rekening.

5. 5

   Deel of embed je winkel

   Deel de link van je winkelpagina, of laat je webbouwer de widget met één regel code op je site zetten.

Een overzicht van alles wat je in het dashboard vindt — elk onderdeel spreekt voor zich zodra je het opent.

Bedrag- en dienst-bonnen

Een bon is een bedrag (vast of vrij te kiezen) óf een dienst met een vaste prijs ('1 uur massage'). Onbeperkt aantal ontwerpen, met thema's per gelegenheid, je eigen kleuren, logo en foto.

Promocodes

Dashboard → Promocodes: percentage korting, vast bedrag of bonustegoed (betaal €50, krijg €60). Met geldigheidsperiode, minimumbedrag, maximaal gebruik en optioneel per bon-ontwerp.

Bon uitgeven

Eén bon rechtstreeks aanmaken voor toonbankverkoop, een geschenk of een compensatie — met of zonder e-mail. Live accounts betalen hierop standaard 1,99% via de maandafrekening.

Bulk uitgeven (B2B)

Tot 1000 bonnen in één keer: bedrag × aantal, of een geplakte ontvangerslijst. De fee betaal je vooraf; codes exporteer je als CSV of laat je automatisch mailen.

Bon bewerken & geschiedenis

Verleng de vervaldatum, corrigeer ontvangergegevens en bekijk per bon de volledige geschiedenis: aangemaakt, geleverd, aangepast, ingewisseld, ongedaan gemaakt.

Geplande levering

Kopers kiezen een leverdatum; de bon wordt die dag gemaild. Vanuit het dashboard kan je een geplande bon ook meteen versturen.

Vervalherinneringen

Ontvangers met resterend saldo krijgen automatisch één herinnering ~30 dagen voor de vervaldatum. Uit te schakelen in Instellingen.

Analytics & rapporten

Inwisselgraad, gemiddelde bonwaarde, omzettrend per maand, top-bonnen en breakage — plus CSV-exports van bestellingen en bonnen voor je boekhouder.

Winkeltaal

Nederlands of Engels per zaak: winkelpagina, checkout, e-mails en dashboard volgen mee.

Wallet-passen (binnenkort)

De bonpagina krijgt 'Bewaar in Apple/Google Wallet'-knoppen zodra de certificaten actief zijn.

Mollie is de aanbevolen betaalprovider voor België en Nederland: iDEAL, Bancontact, kaarten en meer, met uitbetaling op je eigen rekening.

1. 1

   Maak een Mollie-account

   Ga naar mollie.com en registreer je zaak (KBO/KvK-nummer en bankrekening bij de hand). Mollie keurt je account meestal binnen 1–2 werkdagen goed.

2. 2

   Haal je API-key op

   Log in op je Mollie-dashboard → Developers → API-keys. Kopieer de Live API key (begint met live_). Wil je eerst testen zonder echt geld? Gebruik de Test API key (test_).

3. 3

   Plak de key in Kadoobon

   Dashboard → Instellingen → Payments → Mollie. Wij controleren de key meteen bij Mollie; is hij geldig, dan staat je winkel live.

• De betaalpagina van Mollie verschijnt automatisch in de taal van je winkel (Nederlands of Engels).
• Op het bankafschrift van je klant staat “Cadeaubon — jouw zaaknaam”.
• Terugbetaling via Mollie? De bijhorende cadeaubon wordt automatisch ongeldig gemaakt.
• Met een test_-key zijn betalingen gesimuleerd bij Mollie — handig om de volledige flow te proberen.
• Zie je een “Koppel met Mollie”-knop? Dan kan het ook zonder key: één klik, inloggen bij Mollie, klaar — de Kadoobon-fee wordt dan automatisch verrekend.

Liever Stripe? Dan lopen kaartbetalingen ingebed op je eigen pagina (zonder redirect) via Stripe Connect, en wordt de Kadoobon-fee automatisch verrekend.

Klik in Instellingen → Payments op “Connect with Stripe” en doorloop de onboarding van Stripe. Heb je Mollie én Stripe verbonden, dan kies je zelf welke actief is.

De hele integratie is één regel HTML. Geen npm, geen plug-in, geen build-stap — werkt op WordPress, Wix, Squarespace, Webflow of een statische pagina.

Plak dit waar de bonnenshop moet verschijnen:

<script src="https://kadoobon.com/embed.js"
        data-store="jouw-zaak" async></script>

Automatische hoogte

De widget meet zijn eigen inhoud en past de hoogte van het iframe aan — geen scrollbalken, geen CSS nodig.

Eigen plaatsing

Wil je de shop op een specifieke plek (of op meerdere pagina's)? Zet lege containers neer: <div data-kadoobon-store="jouw-zaak"></div> — het script vult ze allemaal.

Volledige checkout in de widget

Bedrag, ontvanger, boodschap en (test)betaling gebeuren binnen het iframe. Alleen de Mollie-betaalpagina opent bovenop de site en keert daarna terug.

Content Security Policy

Laat frame-src en script-src jouw Kadoobon-domein toe als de site een strikte CSP heeft.

Voor kassasystemen en maatwerk: een simpele REST-API met een geheime sleutel per zaak. Genereer je key in Dashboard → Instellingen → API (hij wordt één keer getoond).

GET /api/v1/balance?code=…

Saldo en status van een bon opvragen.

POST /api/v1/redeem

{ code, amount_cents, note? } — bedrag afboeken (deelinwisseling kan). Stuur optioneel een Idempotency-Key header: retries met dezelfde key boeken niet dubbel af.

POST /api/v1/issue

{ amount_cents, recipient_email?, send_email?, … } — een bon uitgeven, optioneel meteen gemaild. Voor live accounts geldt hierop de fee voor handmatige uitgifte (standaard 1,99%).

Stuur de key mee als header: Authorization: Bearer kdb_live_… · Limiet: 120 requests/min.

Geen website? Je winkelpagina is er altijd:

• Deel kadoobon.com/store/jouw-zaak in je Instagram-bio, op Facebook of via e-mail.
• Zet er een QR-code van op je toonbank of raam.
• Verkoop aan de toonbank: reik een bon uit vanuit Dashboard → Issued cards → Issue card, met of zonder e-mail naar de ontvanger.

Inwisselen duurt tien seconden, met eender welk toestel:

• Dashboard → Redeem: tik de code in (of scan de QR op de bon van de klant) en trek het bedrag van de aankoop af.
• Deelinwisselingen kunnen onbeperkt; het saldo wordt automatisch bijgehouden en de klant kan het online checken.
• Een dienst-bon herken je aan het label ('Dienst: 1 uur massage') — wissel hem in met de knop “Volledig saldo”.
• Verkeerd bedrag afgeboekt? Open de bon en maak de inwisseling ongedaan; het saldo komt meteen terug.
• Maak er een kassa-app van: open het dashboard op je telefoon en kies “Zet op beginscherm” — Kadoobon opent dan als app, zonder App Store.
• Rapporten tonen verkoop, ingewisseld bedrag en openstaand saldo — exporteerbaar als CSV voor je boekhouder.