Wallet-Karten aus Ihrem eigenen System ausstellen und aktualisieren.
Apple-Karten signieren, Google-Objekte verwalten und jede Änderung synchron halten ist ein eigenes Projekt. Mit der Vuelvy-API bindet Ihr Technikteam Anmeldungen, Ausgabe, Aktualisierungen, Ereignisse und Einlösungen eines bereits veröffentlichten Programms an. Gestaltung und Veröffentlichung des Programms erfolgen im Dashboard.
Google shares your name, email and profile picture, if available, to verify your identity. This does not subscribe you to marketing. Privacy policy
Benachrichtigungen und Aktualisierungen hängen von den Funktionen und Richtlinien der jeweiligen Wallet-Plattform ab.
- 01Schlüssel mit Berechtigungen je Operation
- 02Idempotency-Key, wo erforderlich
- 03Asynchrone, abfragbare Ausgabe
- 04Dokumentation je vereinbartem Umfang
Was Sie integrieren können
Die Wallet-API v1 deckt den laufenden Betrieb eines veröffentlichten Programms ab. Kartengestaltung und Veröffentlichung von Versionen bleiben im Vuelvy-Dashboard und werden nicht über die API verwaltet. Die API dient der Integration in Ihre Systeme; der Weiterverkauf unter eigener Marke ist ein eigenes Modell und wird im White-Label-Angebot geregelt.
- Anmeldungen, Profile und Einwilligungen
- Ausgabe, Abfrage und Aktualisierung von Karten
- QR-Codes und Links zur Anmeldung
- Ereignisse, Punkte, Vorteile und Einlösungen
Ein minimales Beispiel: Anfrage und Antwort
Um eine Karte auszustellen, sendet Ihr System eine authentifizierte Anfrage mit seinem Schlüssel und einem Idempotency-Key. Die Ausgabe ist asynchron: Die Antwort bestätigt, dass die Operation angenommen wurde, nicht dass der Kunde die Karte bereits in seiner Wallet hat.
- Anfrage: POST /api/wallet/v1/passes mit Authorization: Bearer und dem Header Idempotency-Key.
- JSON-Body: programId des veröffentlichten Programms, optional subscriberId sowie die Kartendaten in data.
- Antwort 202: passId, state „pending“ und operationIds, um den Status der Operation abzufragen.
- Wird dieselbe Anfrage mit demselben Idempotency-Key wiederholt, liefert sie 200, ohne eine weitere Karte anzulegen.
Eindeutige Fehler und sichere Wiederholungen
Jede Antwort zeigt, ob Sie die Anfrage korrigieren, Berechtigungen prüfen oder es erneut versuchen sollten. Operationen, die einen Idempotency-Key verlangen – etwa die Kartenausgabe –, lassen sich nach einem Netzwerkabbruch wiederholen, ohne doppelt ausgeführt zu werden.
- 401 invalid_credentials: Schlüssel fehlt, wurde widerrufen oder ist abgelaufen
- 403 forbidden: Dem Schlüssel fehlt diese Berechtigung
- 400 idempotency_key_required: Header fehlt bei einer Operation, die ihn verlangt
- Anfragelimit je Schlüssel
Apple und Google: eine gemeinsame Schnittstelle ohne falsche Gleichheit
Die API vereinheitlicht die Geschäftslogik, und Vuelvy erzeugt die Variante für jeden Anbieter. Apple und Google behalten unterschiedliche Zugangsdaten, Felder, Aktualisierungen und Hinweise; fehlt eine Funktion auf einer Plattform, wird sie nicht simuliert.
Wie Sie Zugang und Dokumentation erhalten
Die technische Referenz ist nicht öffentlich, und es gibt keine öffentliche OpenAPI-Spezifikation. Wenn Ihr Fall eine Integration braucht, fragen Sie eine Prüfung des Umfangs an: Wir klären, welche Operationen Sie benötigen, wer die Integration verantwortet und welche Daten ausgetauscht werden. Danach werden Schlüssel mit minimalen Berechtigungen für Ihre Organisation erstellt, und wir stellen die Dokumentation genau dieser Endpunkte bereit. Jeder Fall wird vor Vertragsabschluss individuell geprüft.
- Anwendungsfall und benötigte Operationen
- Minimale Berechtigungen je Schlüssel
- Personenbezogene Daten und Einwilligungen geprüft
- Testplan vor dem Betrieb mit echten Kunden
FAQ
Häufige Fragen
Ist die API-Dokumentation öffentlich?
Nein. Die Referenz der Endpunkte wird geteilt, sobald der technische Umfang vereinbart ist – zusammen mit Schlüsseln, die nur die minimal nötigen Berechtigungen für Ihre Organisation haben. Eine öffentliche OpenAPI-Spezifikation gibt es nicht.
Kann ich Karten für mehrere Marken ausstellen?
Ja, mit getrennten API-Schlüsseln: Jeder Schlüssel gehört zu einer Organisation und bedient nur deren Programme, Karten und Daten. Eine Agentur mit mehreren Marken nutzt für jede Organisation eigene Schlüssel.
Was kann die Wallet-Marketing-API automatisieren?
Die API verbindet Anmeldung, Kartenausgabe, Aktualisierungen, Status und Geschäftsereignisse mit Apple Wallet und Google Wallet. Der Umfang wird je Anwendungsfall festgelegt, damit nur benötigte Operationen bereitstehen.
Kann eine Integration Apple Wallet und Google Wallet unterstützen?
Vuelvy vereinheitlicht die Geschäftslogik und passt die Ausgabe an den Anbieter an. Apple und Google behalten unterschiedliche Modelle, Zugangsdaten und Funktionen. Gemeinsame Abläufe müssen nicht doppelt entwickelt werden, ohne beide Plattformen gleichzusetzen.
Wie werden API- und Datenzugriff geschützt?
Zugriffe werden authentifiziert, auf die Organisation begrenzt und nachvollziehbar protokolliert. Die Daten jeder Marke bleiben getrennt; wie die Anbieter-Zugangsdaten organisiert sind – bei Google etwa über ein eigenes Ausstellerkonto oder Vuelvy als Aggregator –, wird im vereinbarten Umfang dokumentiert.
Sendet die API Webhooks an mein System?
Die Integration ist so ausgelegt, dass Ihr System Ereignisse sendet und den Status von Operationen abfragt. Braucht Ihr Fall Benachrichtigungen von Vuelvy an ein anderes System, wird das in der Umfangsprüfung bewertet, bevor es zugesagt wird. Operationen, die einen Idempotency-Key verlangen, werden bei einer Wiederholung nicht doppelt ausgeführt.
Sprechen wir über Ihren Bedarf
Passt Wallet zu Ihrem Unternehmen?
Schildern Sie uns Ihren Fall, und wir melden uns per E-Mail, um Integrationen, Startplan und nächsten Schritt zu besprechen. Ohne Standardpräsentation und unverbindlich.
Google shares your name, email and profile picture, if available, to verify your identity. This does not subscribe you to marketing. Privacy policy