Händlerterminal einrichten

In diesem Leitfaden wird beschrieben, wie Smart-Bonus für Händler konfiguriert wird.

Händlerterminal einrichten, um Tickets über Smart-Bonus einzulösen

Händler und Terminalanbieter verlassen sich für die Konfiguration ihrer Terminals für die Smart-Bonus-Einlösung auf Karten-/Ticketentwickler. Sobald das Terminal eines Händlers für Smart-Bonus eingerichtet ist, kann ein Karten-/Ticketentwickler festlegen, dass bestimmte Klassen am Terminal des Händlers eingelöst werden können.

So können Sie prüfen, ob die Händlerterminals Ihre Karte über NFC einlösen können:

  • Ermitteln Sie das Ausstellerkonto für die Karten-/Ticketentwicklung eines bestimmten Händlers.
  • Ermitteln Sie das für Smart-Bonus aktivierte Einlösungsausstellerkonto.
  • Aktivieren Sie eine Klasse für Smart-Bonus bei Einlösungsausstellern.

Die folgenden Werte richten Sie für Smart-Bonus ein.

Legen Sie die folgenden Werte für ein Einlösungsausstellerkonto fest:

  • Collector-ID, die automatisch generiert wird, wenn einem Einlösungsausstellerkonto ein öffentlicher Schlüssel zugewiesen wird
  • Schlüsselversion
  • Öffentlicher Schlüssel

Terminalanbieter legen in den Geschäften der Händler folgende Werte für die Terminals fest:

  • Collector-ID
  • Schlüsselversion
  • Privater Schlüssel

Legen Sie die folgenden Werte für Ihre Karte bzw. Ihr Ticket fest:

  • Aktivieren Sie eine Klasse, die mit Smart Tap eingelöst werden kann.
  • Legen Sie das Einlösungsausstellerkonto fest, für die Smart-Bonus aktiviert ist.
  • Legen Sie den zu vermittelnden Wert fest: smartTapRedemptionValue.

Weitere Informationen zu diesen Werten finden Sie unter Informationen zu Sammlungs-IDs.

Ermitteln Sie das Ausstellerkonto, das Karten/Tickets enthält.

Sie müssen das Ausstellerkonto ermitteln, das Karten/Tickets für Händler enthält. Dieses Ausstellerkonto enthält die Klassen und Objekte von Karten/Tickets, die Sie für die einzelnen Händler entwickeln. Sie haben zwei Möglichkeiten zur Auswahl:

  • Ein zentrales Ausstellerkonto für alle Ihre Händler.
  • Ein neues Ausstellerkonto pro Händler.

Hier ein Beispiel:

Foo-Loyalty verwaltet separate Treuepunkteprogramme für iLuvCoffee und teaLuv. Sie können die Karten/Tickets auf eine der folgenden Arten konfigurieren:

  • Alle Klassen unter dem Ausstellerkonto „Foo-Loyalty“ zusammenfassen. Diese Option ist die bessere Wahl, wenn Sie wissen möchten, wo Ihre Karten/Tickets auf Klassenebene eingelöst werden können. Diese Option empfiehlt sich auch, wenn Sie Ihrer Händler-API nie Zugriff auf dieses Ausstellerkonto gewähren.
  • Zwei separate Konten erstellen: „iLuvCoffee via Foo-Loyalty“ und „teaLuv via Foo-Loyalty“. Diese Option ist zu bevorzugen, wenn Sie davon ausgehen möchten, dass alle Klassen eines bestimmten Ausstellerkontos für einen bestimmten Händler einlösbar sind, oder wenn Sie ihnen API-Zugriff auf das Ausstellerkonto gewähren müssen.

Unter Informationen zu Sammlungs-IDs können Sie nachlesen, welche Option für Sie am besten geeignet ist.

Einlösungsausstellerkonto ermitteln

Sie müssen feststellen, ob das Terminal eines Händlers so konfiguriert ist, dass es Ihre Karte bzw. Ihr Ticket lesen kann. In den folgenden Abschnitten werden die beiden möglichen Szenarien beschrieben.

Szenario 1: Der Händler kann bereits Karten/Tickets einlösen

Wenn der Händler bestätigt, dass er bereits Karten/Tickets über Google Wallet mit seinen Terminals einlösen kann, gehen Sie so vor:

  1. Fordern Sie vom Händler die ID des Einlösungsausstellerkonto an, das für Smart-Bonus aktiviert ist.
  2. Aktivieren Sie Ihre einlösbaren Karten/Tickets an dessen Terminal. Eine Anleitung finden Sie unter Klasse für Smart-Bonus bei Einlösungsausstellern aktivieren.

Szenario 2: Das Terminal des Händlers unterstützt Smart-Bonus, allerdings sind Karten/Tickets nicht für Smart-Bonus aktiviert

Wenn der Händler ein Terminal hat, das Smart-Bonus unterstützt, die Funktion aber noch nicht verwendet hat, müssen Sie dem Händler helfen, Smart-Bonus für sein Terminal einzurichten.

Smart-Bonus für Händler aktivieren

So aktivieren Sie Smart-Bonus für Händler:

  1. Ermitteln Sie das Einlösungsausstellerkonto, das für Smart-Bonus aktiviert werden soll. Dazu gibt es zwei Möglichkeiten:
    1. Erstellen Sie eines im Namen des Händlers. Die Kontaktdaten des neuen Ausstellers müssen die Informationen des Händlers enthalten.
      1. Über das Formular: Zugriff auf die Google Wallet API beantragen
      2. Über REST API: Ausstellerkonto erstellen
    2. Prüfen Sie, ob Sie ein Konto wiederverwenden können, das zuvor entwickelte Karten/Tickets enthält.
      1. Wenn das Ausstellerkonto für die Ticket-/Kartenentwicklung eine Klasse für verschiedene Händler enthält, müssen Sie im Namen des Händlers ein neues Konto einrichten. Verwenden Sie zum Einrichten eines neuen Kontos eine der beiden oben beschriebenen Methoden. Das ist das „Einlösungsausstellerkonto“.
      2. Wenn das Ausstellerkonto für die Karten-/Ticketentwicklung nur Klassen für den jeweiligen Händler enthält, geben Sie es als das Einlösungsausstellerkonto an. Sie müssen kein neues beantragen.
  2. Fordern Sie den öffentlichen Schlüssel und die Schlüsselversion vom Terminalanbieter an.
    1. Wenn der Terminalanbieter zuerst eine Collector-ID anfordert, fahren Sie mit Schritt 3 fort, um die Collector-ID zu generieren.
  3. Verwenden Sie die API, um Ihrem Einlösungsaussteller einen oder mehrere öffentliche Schlüssel und eine oder mehrere Schlüsselversionen zuzuweisen.
    1. Dadurch wird dem Einlösungsaussteller eine Collector-ID zugewiesen.
    2. Informationen zum Prüfen der Collector-ID finden Sie unter Automatisch generierte Collector-ID abrufen.
  4. Geben Sie dem Terminalanbieter die Collector-ID, die Sie in Schritt 3 eingerichtet haben.
  5. Stellen Sie dem Händler die folgenden Informationen zur Verfügung:
    1. Geben Sie in Schritt 1 die Einlösungsaussteller-ID und den Link zum Merchant Center-Konto der Google Wallet API an.
    2. Geben Sie in Schritt 3 die Collector-ID an.
    3. Teilen Sie dem Händler mit, dass er die Konto-ID und die Collector-ID des Einlösungsausstellers dauerhaft speichern soll. Der Händler muss jedem Karten-/Ticketentwickler, der seine Klassen für die Smart-Bonus-Einlösung aktivieren muss, die Konto-ID des Einlösungsausstellers mitteilen.

Jeder Karten-/Ticketentwickler kann eine Klasse so zuordnen, dass sie mit Smart-Bonus eingelöst werden kann, sofern er die Konto-ID des Einlösungsausstellers hat.

Klasse für Smart-Bonus bei Einlösungsausstellern aktivieren

Eine Klasse kann von verschiedenen Händlern eingelöst werden. So kann beispielsweise dasselbe Treuepunkteprogramm, das durch eine Klasse dargestellt wird, bei verschiedenen Händlern verwendet werden. In diesem Fall sind der einzelnen Klasse mehrere Konto-IDs für Einlösungsaussteller zugewiesen, die die verschiedenen Händler repräsentieren.

Sie können mit einer REST API aktivieren, dass eine Klasse von verschiedenen Händlern eingelöst wird. Weitere Informationen zur Verwendung der API zum Konfigurieren von Smart-Bonus finden Sie im Abschnitt Karten/Tickets für Smart-Bonus-Einlösung aktivieren.

Weitere Informationen darüber, was von Karten/Tickets an das Terminal über NFC übertragen wird, finden Sie im Abschnitt Von Karten/Tickets übertragene Werte.