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)
- Klanten die je al hebt hergebruiken — is iemand die je systeem inschrijft al aangemeld via jouw aanmeldpagina, dan herkent Passtastic diegene aan e-mail of telefoon en voegt je referentie toe aan de kaart die hij of zij al heeft, in plaats van een tweede uit te geven
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 Test-sleutel maken om risicovrij te testen, of op Live-sleutel maken zodra je klaar bent om echte klanten te koppelen.
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 (bij een testsleutel: Je nieuwe test-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 beheerders kunnen API-sleutels aanmaken of intrekken.
Probeer het eerst met een test-sleutel
Test-sleutels werken op elk abonnement, ook tijdens je proefperiode — geen upgrade nodig. Testklanten krijgen een echte wallet-kaart, met het label TEST, en worden automatisch na 30 dagen verwijderd — je hoeft zelf niets op te ruimen.
Volg de Quickstart in de technische documentatie met je test-sleutel — die laat stap voor stap zien hoe je een testklant inschrijft en een kaart aan je eigen telefoon toevoegt, nog voordat er een echte klant bij betrokken is.
Zodra je integratie van begin tot eind werkt, ga je terug naar API & webhooks en klik je op Live-sleutel maken om over te schakelen naar echte klanten. Live-sleutels zijn beschikbaar vanaf Multi-Locatie en hoger.
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
- Kaart verlopen
- Kaart verlengd
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 beheerders 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, of ga direct naar de API-referentie voor het request-/response-schema van elk endpoint. Je bereikt beide ook altijd via de links Lees de API-documentatie en API-referentie bovenaan de pagina API & webhooks — de API-referentie opent in een nieuw tabblad.