Auf dieser Seite werden die vom Smart-Bonus-Protokoll verwendeten IDs beschrieben.
Überblick
Das Smart-Bonus-Protokoll sendet Informationen zu Karten/Tickets, die in der Google Wallet App eines Nutzers und der Terminalanwendung gespeichert sind. In der folgenden Grafik wird der Kommunikationsablauf zwischen dem Terminal und Google Wallet zusammengefasst:
Da Händler mehrere Unternehmen oder Auftragnehmer zur Entwicklung von Karten/Tickets verwenden können, verwendet Google drei IDs, um das Senden von Informationen zwischen Google Wallet und Terminals zu erleichtern. So können Händler, die einen bestimmten Terminalanbieter verwenden, Karten/Tickets verschiedener Entwickler einlösen. Die folgenden IDs sind die drei „Sammlungs-IDs“, die im Smart-Bonus-Protokoll verwendet werden.
Einlösungsaussteller-ID
Eine Einlösungsaussteller-ID ist eine bestimmte Art von Aussteller-ID. Die Einlösungsaussteller-ID steht für einen einzelnen Händler. Im Gegensatz dazu kann eine Aussteller-ID für einen Karten-/Ticketentwickler eine Plattform darstellen, auf der Karten-/Ticketklassen für viele verschiedene Händler gespeichert sind. Eine Plattform, auf der Karten-/Ticketklassen für mehrere Händler gespeichert sind, wird auch als Aggregator bezeichnet.
Einlösungsaussteller werden nicht nur für Smart-Bonus verwendet. Einlösungsaussteller werden beispielsweise auch verwendet, um geobasierte Benachrichtigungserinnerungen basierend auf den Standorten des Einlösungsausstellers zu rendern. Daher ist eine Aussteller-ID, die auf einer Karte bzw. einem Ticket als Einlösungsaussteller aufgeführt ist, möglicherweise nicht für Smart-Bonus konfiguriert.
Einlösungsaussteller-ID vs. Aussteller-ID
Die Aussteller-ID ist die eindeutige Kennung eines Google Wallet-Ausstellerkontos. Die Aussteller-ID findest du in der Google Pay & Wallet Console.
Ein Aussteller kann ein Händler (z. B. ein Restaurant), ein Angebotsanbieter oder ein Terminalhersteller sein. Wenn Karten-/Ticketklassen und -objekte entwickelt werden, sind sie mit einer bestimmten Aussteller-ID verknüpft. Die Aussteller-ID ist sowohl in den Klassen-IDs als auch in den Objekt-IDs enthalten.
ID | Format | Hinweise |
---|---|---|
Klassen-ID | issuerId.classSuffix
|
Das classSuffix ist ein eindeutiger, vom Entwickler definierter Wert für eine bestimmte Karten-/Ticketklasse (z. B. eine Treuestufe). |
Objekt-ID | issuerId.objectSuffix
|
Das objectSuffix ist ein eindeutiger, vom Entwickler definierter Wert für ein bestimmtes Karten-/Ticketobjekt (z. B. eine Nutzer-ID). |
Ein Aussteller kann beliebig viele Klassen erstellen.
Collector-ID
Wenn ein Händler Smart-Bonus an seinen Terminals unterstützt, hat der Einlösungsaussteller eine Collector-ID. Die Collector-ID ist eine numerische ID (8 Ziffern), mit der Terminals sich identifizieren. Da ein Einlösungsaussteller mehrere Händler unterstützen kann, wird die Collector-ID verwendet, um die Karte bzw. das Ticket eines bestimmten Händlers anzufordern.
Wenn ein Nutzer sein Gerät an ein Smart-Bonus-fähiges Terminal hält, sendet das Terminal die Collector-ID an das Gerät des Nutzers. Das Gerät authentifiziert sich dann mit dem öffentlichen Schlüssel für diese Collector-ID beim Terminal. Weitere Informationen finden Sie unter Kommunikationsablauf.
Wichtige Hinweise:
- Einer Aussteller-ID wird nur eine Collector-ID zugewiesen
- Eine Collector-ID ist für alle Aussteller-IDs eindeutig
Informationen zum Abrufen einer Collector-ID für deine Aussteller-ID findest du unter Händlerkonfiguration.
Karten-/Ticketklassen-ID
Eine Klassen-ID identifiziert eine bestimmte Stufe oder einen bestimmten Karten-/Tickettyp. Eine Klassen-ID hat das folgende Format:
issuerId.classSuffix
Das Klassensuffix ist ein vom Entwickler definierter Wert, der für diese Karten-/Ticketklasse eindeutig ist. Ein Karten-/Ticketobjekt, das auf diese Klassen-ID verweist, wird in der Google Wallet-App eines Nutzers gespeichert.