De Passtastic API gebruiken
Wat de API je laat doen
De Passtastic API verbindt je eigen systemen — een aangepast kassasysteem, een CRM, een interne app — rechtstreeks met je loyaliteitsprogramma. Hiermee kun je:
- Klanten inschrijven en wallet-kaarten uitgeven vanuit je eigen aanmeldflow
- Stempels of punten toevoegen, en het saldo van een klant bekijken, vanuit je eigen kassa of backoffice
- Real-time meldingen ontvangen met webhooks — in plaats van steeds te polsen, stuurt Passtastic direct een gebeurtenis naar je systeem zodra er iets gebeurt (een klant schrijft zich in, een beloning wordt ingewisseld, en meer)
Dit is voor bedrijven die een eigen integratie bouwen. Wil je gewoon een kant-en-klare koppeling, bekijk dan Square POS koppelen of Kassasystemen & integraties — zonder code.
API-toegang hangt af van je abonnement. Is het niet inbegrepen, dan zie je een upgrade-aanbod wanneer je API & webhooks opent in Instellingen.
Een API-sleutel aanmaken
1. Open Instellingen, dan API & webhooks (onder Bedrijf).
2. Klik op het tabblad API-sleutels op Sleutel maken.
3. Geef de sleutel een naam zodat je later weet waarvoor hij is (bijv. "productie-CRM").
4. Je nieuwe sleutel wordt eenmalig getoond, in het venster Je nieuwe API-sleutel. Kopieer hem nu — je kunt hem daarna niet meer zien. Klik op Kopiëren, of op Tonen om hem eerst te bekijken.
Behandel deze sleutel als een wachtwoord. Iedereen die hem heeft, kan via de API namens je account handelen.
5. Bewaar de sleutel veilig in je eigen systeem (een omgevingsvariabele, een secrets manager) en stuur hem als authenticatie-header mee met elk verzoek — het exacte formaat staat in de technische documentatie hieronder.
Alleen admins kunnen API-sleutels aanmaken of intrekken.
Sleutel kwijt of gecompromitteerd?
Sleutels worden na het aanmaken niet opnieuw getoond. Ben je er een kwijt, of denk je dat hij is uitgelekt, open dan API-sleutels en klik bij die sleutel op Intrekken — dat stopt hem meteen — en maak daarna een nieuwe aan voor je integratie.
Een webhook instellen
Met webhooks reageert je systeem direct zodra er iets gebeurt in Passtastic, zonder dat je steeds de API hoeft te bevragen.
1. Klik op het tabblad Webhooks op Endpoint toevoegen.
2. Voer de Endpoint-URL in — het adres op je eigen systeem dat de gebeurtenis ontvangt (bijv. `https://jouw-systeem.com/hook`).
3. Kies bij Gebeurtenissen welke je wilt ontvangen:
- Klant ingeschreven
- Saldo bijgewerkt
- Niveau gewijzigd
- Beloning ingewisseld
4. Sla op. Je ondertekeningsgeheim wordt eenmalig getoond, in het venster Ondertekeningsgeheim — kopieer het nu. Gebruik het om te verifiëren dat een webhook-verzoek echt van Passtastic komt (de technische documentatie legt uit hoe je de handtekening controleert).
Alleen admins kunnen webhooks aanmaken of bewerken.
Elk webhook-endpoint toont zijn recente bezorgingen, zodat je kunt zien of een aanroep is gelukt of mislukt, en je een mislukte bezorging opnieuw kunt verzenden zodra je systeem weer online is, zonder op de volgende gebeurtenis te wachten.
Een webhook bewerken of uitschakelen
Open het endpoint en klik op Bewerken om de URL of gebeurtenissen te wijzigen, of zet de status op Uitgeschakeld om bezorgingen te pauzeren zonder hem te verwijderen. Klik op Verwijderen om hem definitief te verwijderen.
Waar je de volledige technische documentatie vindt
Deze gids behandelt het dashboard-gedeelte — het aanmaken van sleutels en webhooks. Voor endpoints, request-/response-formaten, authenticatie-headers, foutcodes en codevoorbeelden, bekijk de volledige API-documentatie. Je bereikt deze ook altijd via de link Lees de API-documentatie bovenaan de pagina API & webhooks.