Die Passtastic API nutzen | Passtastic Help
Passtastic
Explore
Product
Loyalty app
Pricing
Use Cases
Customer Stories
Help
No account yet? Sign up free

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)
  • Kunden, die du schon hast, weiterverwenden — hat sich jemand, den dein System registriert, schon über deine Anmeldeseite angemeldet, erkennt Passtastic diese Person anhand von E-Mail oder Telefon und fügt deine Referenz der Karte hinzu, die sie schon hat, statt eine zweite auszustellen

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 Test-Schlüssel erstellen, um ihn risikofrei auszuprobieren, oder auf Live-Schlüssel erstellen, sobald du bereit bist, echte Kunden anzubinden.

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 (bei einem Testschlüssel: Dein neuer Test-Schlüssel). 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 Administratoren können API-Schlüssel erstellen oder widerrufen.

Zuerst mit einem Test-Schlüssel ausprobieren

Test-Schlüssel funktionieren in jedem Tarif, auch in deiner Testphase — kein Upgrade nötig. Test-Kunden erhalten einen echten Wallet-Pass, markiert mit TEST, und werden nach 30 Tagen automatisch entfernt — du musst nichts von Hand aufräumen.

Folge dem Quickstart in der technischen Dokumentation mit deinem Test-Schlüssel — er zeigt dir Schritt für Schritt, wie du einen Testkunden registrierst und eine Karte auf deinem eigenen Handy hinzufügst, bevor auch nur ein echter Kunde beteiligt ist.

Sobald deine Integration durchgehend funktioniert, komm zurück zu API & Webhooks und klicke auf Live-Schlüssel erstellen, um auf echte Kunden umzusteigen. Live-Schlüssel sind ab Mehrere Standorte verfügbar.

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
  • Karte abgelaufen
  • Karte verlängert

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 Administratoren 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, oder springe direkt zur API-Referenz für das Anfrage-/Antwortschema jedes Endpunkts. Du erreichst beide auch jederzeit über die Links API-Dokumentation lesen und API-Referenz oben auf der Seite API & Webhooks — die API-Referenz öffnet sich in einem neuen Tab.

Häufige Fragen

Brauche ich ein Kassensystem, um die API zu nutzen?
Nein. Die API verbindet deine eigenen Systeme — ein individuelles Kassensystem, CRM oder eine App. Wenn du lieber eine fertige Verbindung nutzen willst, sieh dir Square POS verbinden oder Kassensysteme & Integrationen an.
Erstellt meine Integration doppelte Kunden?
Nein. Wenn dein System jemanden registriert, prüft Passtastic zuerst, ob dieser Kunde in deinem Konto schon existiert — anhand der Referenz, die dein System sendet, dann anhand der E-Mail, dann anhand des Telefons. Ist das der Fall, verknüpft Passtastic deine Referenz mit der bestehenden Karte, statt eine zweite auszustellen, sodass Stempel und Punkte dort bleiben, wo sie sind. Teilen sich zwei Kunden dieselbe E-Mail-Adresse oder Telefonnummer, rät Passtastic nicht — es gibt einen Fehler zurück, der beide nennt, damit dein Entwickler die richtige Person auswählen kann.
Erfährt mein System, wann die Karte eines Kunden abläuft?
Ja. Wenn deine Karte eine Gültigkeitsdauer hat (Kartengültigkeit unter Kartendetails im Tab Einrichtung des Programms), wähle bei deinem Webhook Karte abgelaufen und Karte verlängert: Dein System erfährt, wann eine Karte abläuft und wann sie verlängert wird, auch wenn du sie in Passtastic verlängerst. Dein Entwickler kann außerdem das Enddatum jedes Kunden abrufen und eine Karte aus deinem System verlängern. Zum Ausprobieren, bevor eine echte Karte abläuft, kann ein Test-Schlüssel die Karte eines Test-Kunden sofort ablaufen lassen. Details findest du in der API-Dokumentation.
Ist der API-Zugriff in meinem Tarif enthalten?
Die API ist in Mehrere Standorte und Gruppen & Marken enthalten. In Einzelstandort zeigt API & Webhooks in den Einstellungen ein Upgrade-Angebot statt deiner Schlüssel.
Wo finde ich die ID einer Karte?
Öffne den Tab Teilen des Programms. Unter In Social Media oder Website teilen siehst du ihren Link: Der Teil nach `/get-pass/` ist die Karten-ID. Kopiere die ID nicht aus der Adresse der Programmseite, denn dort kann eine andere stehen. Dein Entwickler kann auch alle deine Karten mit ihren IDs über die API abrufen (`GET /api/v1/cards`).
Mein Entwickler bekommt „Missing scope(s): cards:read". Was mache ich?
Der Schlüssel wurde erstellt, bevor die API Karten auflisten konnte. Erstelle einen neuen Schlüssel (API-Schlüssel → Schlüssel erstellen), gib ihn deinem Entwickler und klicke dann beim alten auf Widerrufen.
Wer kann API-Schlüssel und Webhooks verwalten?
Nur Administratoren. Bearbeiter und Betrachter sehen keine Möglichkeit, einen Schlüssel oder Webhook zu erstellen, zu bearbeiten oder zu widerrufen.
Kann ich mehrere API-Schlüssel haben?
Ja — erstelle einen eigenen Schlüssel pro System oder Umgebung (z. B. einen für dein CRM, einen für eine Staging-Umgebung), damit du einen widerrufen kannst, ohne die anderen zu unterbrechen.
Ein Webhook empfängt keine Ereignisse mehr — was ist passiert?
Öffne den Endpunkt und prüfe die letzten Zustellungen auf den Fehlergrund (z. B. hat dein Server einen Fehler zurückgegeben oder ein Timeout ausgelöst). Behebe das Problem bei dir und klicke dann bei der fehlgeschlagenen Zustellung auf Erneut senden.