Die Passtastic API nutzen
Was die API dir ermöglicht
Die Passtastic API verbindet deine eigenen Systeme — ein individuelles Kassensystem, ein CRM, eine interne App — direkt mit deinem Treueprogramm. Damit kannst du:
- Kunden registrieren und Wallet-Karten aus deinem eigenen Anmeldeprozess ausstellen
- Stempel oder Punkte hinzufügen und den Kontostand eines Kunden prüfen — direkt aus deiner eigenen Kasse oder Verwaltung
- In Echtzeit benachrichtigt werden mit Webhooks — statt ständig nachzufragen, sendet Passtastic dir sofort ein Ereignis, wenn etwas passiert (ein Kunde registriert sich, eine Belohnung wird eingelöst, und mehr)
Das ist für Unternehmen, die eine individuelle Integration bauen. Wenn du nur eine fertige Verbindung willst, sieh dir Square POS verbinden oder Kassensysteme & Integrationen an — ganz ohne Code.
Der API-Zugriff hängt von deinem Tarif ab. Ist er nicht enthalten, siehst du beim Öffnen von API & Webhooks in den Einstellungen ein Upgrade-Angebot.
Einen API-Schlüssel erstellen
1. Öffne Einstellungen, dann API & Webhooks (unter Geschäft).
2. Klicke im Tab API-Schlüssel auf Schlüssel erstellen.
3. Gib einen Schlüsselnamen ein, damit du später weißt, wofür er ist (z. B. „Produktions-CRM").
4. Dein neuer Schlüssel wird einmalig im Fenster Dein neuer API-Schlüssel angezeigt. Kopiere ihn jetzt — du wirst ihn danach nicht mehr sehen können. Klicke auf Kopieren, oder auf Anzeigen, um ihn vorher einzusehen.
Behandle diesen Schlüssel wie ein Passwort. Wer ihn hat, kann über die API in deinem Namen handeln.
5. Speichere den Schlüssel sicher in deinem eigenen System (eine Umgebungsvariable, ein Secrets-Manager) und sende ihn als Authentifizierungs-Header mit jeder Anfrage — das genaue Format findest du in der technischen Referenz unten.
Nur Admins können API-Schlüssel erstellen oder widerrufen.
Schlüssel verloren oder kompromittiert?
Schlüssel werden nach dem Erstellen nicht erneut angezeigt. Wenn du einen verloren hast oder vermutest, dass er offengelegt wurde, öffne API-Schlüssel und klicke bei ihm auf Widerrufen — das stoppt ihn sofort — und erstelle danach einen neuen für deine Integration.
Einen Webhook einrichten
Mit Webhooks reagiert dein System sofort, wenn in Passtastic etwas passiert — ohne dass du ständig bei der API nachfragen musst.
1. Klicke im Tab Webhooks auf Endpunkt hinzufügen.
2. Gib die Endpunkt-URL ein — die Adresse in deinem eigenen System, die das Ereignis empfängt (z. B. `https://dein-system.com/hook`).
3. Wähle unter Ereignisse aus, welche Ereignisse du erhalten willst:
- Kunde registriert
- Guthaben aktualisiert
- Level geändert
- Belohnung eingelöst
4. Speichern. Dein Signatur-Secret wird einmalig im Fenster Signatur-Secret angezeigt — kopiere es jetzt. Damit prüfst du, ob eine Webhook-Anfrage wirklich von Passtastic stammt (wie du die Signatur prüfst, steht in der technischen Referenz).
Nur Admins können Webhooks erstellen oder bearbeiten.
Jeder Webhook-Endpunkt zeigt seine letzten Zustellungen, damit du sehen kannst, ob ein Aufruf erfolgreich war oder fehlgeschlagen ist — und kannst eine fehlgeschlagene Zustellung erneut senden, sobald dein System wieder läuft, ohne auf das nächste Ereignis zu warten.
Webhook bearbeiten oder deaktivieren
Öffne den Endpunkt und klicke auf Bearbeiten, um URL oder Ereignisse zu ändern, oder setze den Status auf Deaktiviert, um Zustellungen zu pausieren, ohne ihn zu löschen. Klicke auf Löschen, um ihn endgültig zu entfernen.
Wo du die vollständige technische Referenz findest
Dieser Leitfaden deckt die Seite im Dashboard ab — das Erstellen von Schlüsseln und Webhooks. Endpunkte, Anfrage-/Antwortformate, Authentifizierungs-Header, Fehlercodes und Codebeispiele findest du in der vollständigen API-Dokumentation. Du erreichst sie auch jederzeit über den Link API-Dokumentation lesen oben auf der Seite API & Webhooks.