Bordkarten automatisch hinzufügen

Hintergrund

Mit dieser Funktion können Fluggesellschaften Bordkarten automatisch an Google Wallet eines Nutzers senden. Das ist besonders für Vielflieger von Vorteil, da sie ihre Bordkarten aufgrund ihrer höheren Reisehäufigkeit einfacher und bequemer in Wallet hinzufügen können.

Das geschieht automatisch, unabhängig vom Check-in-Kanal (z.B. Web, App oder Flughafen-Kiosk). Die Fluggesellschaft verwendet die Treuekontonummer des Nutzers, um den Pass zuzuordnen und zu übertragen.

Hinweis: Diese Funktion ist eine spezielle Implementierung der Funktion „Automatisch verknüpfte Karten“. Im Rest des Dokuments werden die allgemeineren Begriffe „automatisch verknüpfte Karten/Tickets“ sowie „primäre Karte/primäres Ticket“ und „verknüpfte Karte/verknüpftes Ticket“ verwendet, um diese Funktion zu beschreiben.

Funktionsweise

Schritt 1: Vielfliegerkarte zu Wallet hinzufügen

Schritt 2: Neue Bordkarten für den Vielflieger automatisch hinzufügen, indem Sie sie mit seiner Kundenkarte in Wallet verknüpfen.

Hinweise zur Verwendung automatisch verknüpfter Karten

• Für das primäre Objekt und das verknüpfte Objekt muss dieselbe issuerId verwendet werden.
• Pro primärem Objekt sind maximal 50 verknüpfte Objekte zulässig.
• Das automatische Pushen verknüpfter Karten und Tickets ist nicht garantiert und wird nach dem Best-Effort-Prinzip durchgeführt. Nutzer können den Empfang automatisch verknüpfter Karten/Tickets deaktivieren. Wenn der Anwendungsfall kritisch ist und der Nutzer die verknüpfte Karte erhalten muss, empfehlen wir, über einen anderen Kanal zu kommunizieren, um sicherzustellen, dass der Nutzer die Karte hinzufügt.
• Die Nutzungsrichtlinien für Google Wallet wurden aktualisiert und enthalten jetzt Richtlinien zur Verwendung von automatisch verknüpften Karten/Tickets, die eingehalten werden müssen.

Integrationsschritte

Wenn Sie bereits ein primary-Objekt erstellt haben, können Sie Schritt 1 überspringen.

1. Erstellen Sie ein Objekt für einen beliebigen Kartentyp, der mit den erforderlichen Parametern aufgeführt ist. Dies ist das primäre Objekt.
2. Erstellen Sie ein weiteres Objekt eines beliebigen aufgeführten Karten-/Ticketyps. Dies ist das verknüpfte Objekt.
3. Aktualisieren Sie das primäre Objekt entweder vor oder nach dem Speichern mit der ID des verknüpften Objekts im Parameter „linkedObjectIds“.

Es ist eine Mindestnutzlast erforderlich, um die linkedObjectIds für eine primäre Karte festzulegen. Die drei erforderlichen Parameter sind:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Beispiel für eine JSON-Anfrage zum Hinzufügen eines verknüpften Objekts zu einem Passobjekt

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Beispiel für eine JSON-Antwort nach dem Verknüpfen eines Objekts mit einem Pass-Objekt

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Erwartetes Verhalten

Nachdem Sie eine erfolgreiche Antwort erhalten haben, sollten Geräte mit dem aktualisierten Ticket das verknüpfte Ticket erhalten. Diese verknüpfte Karte wird mit der primären Karte gruppiert. Nutzer können die verknüpfte Karte oder das verknüpfte Ticket aufrufen, indem sie nach rechts wischen.

Ausnahmebehandlung

Bei einer falschen Verwendung der API können folgende Fehler auftreten: