Auf dieser Seite werden die vom Smart-Bonus-Protokoll verwendeten IDs beschrieben.
Übersicht
Das Smart-Bonus-Protokoll sendet Informationen zu Karten/Tickets, die in der Google Wallet App eines Nutzers und in 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 ermöglichen. 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 Klassen 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 genutzt. Einlösungsaussteller werden beispielsweise auch zum Rendern standortbezogener Erinnerungen auf der Grundlage der Standorte des Einlösungsausstellers eingesetzt. 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 und 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 Karten-/Ticket-IDs als auch in Objekt-IDs enthalten.
| ID | Format | Anmerkungen |
|---|---|---|
| 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/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 findest du unter Kommunikationsablauf.
Wichtige Hinweise:
- Einer Aussteller-ID wird jeweils 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 Karten-/Ticketklassen-ID kennzeichnet eine bestimmte Stufe oder eine bestimmte Art von Karte/Ticket. 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.