Sammlungs-IDs

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:

Der Kommunikationsablauf beginnt mit der Einigung auf das zu verwendende Protokoll. Anschließend werden Schlüssel und dann Karten/Tickets ausgetauscht.

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.