Nachdem Sie eine Karte oder ein Ticket erstellt und in einem signierten JWT codiert haben, können Sie sie bzw. es überall dort ausstellen, wo der Link „Zu Google Wallet hinzufügen“ unterstützt wird. Dazu präsentieren Sie dem Nutzer die Schaltfläche „Zu Google Wallet hinzufügen“ oder einen Hyperlink. Wenn er darauf tippt, wird die Karte bzw. das Ticket in seinem Google Wallet gespeichert. Beispiele für die Verwendung dieser Methode sind mobile Apps, Websites, E-Mails, Chats und SMS.
Vorbereitung
Bevor Sie versuchen, eine Karte oder ein Ticket auszustellen, müssen Sie Folgendes tun:
- Führen Sie alle Schritte im Onboarding-Leitfaden aus.
- Erstellen Sie mindestens eine Karten-/Ticketklasse.
- Erstelle mindestens ein Karten-/Ticketobjekt.
- Codieren Sie Ihre Karten-/Ticketklasse und Ihr Karten-/Ticketobjekt in einem JWT.
- Signieren Sie Ihr JWT mit Ihrem Google Cloud-Dienstkontoschlüssel.
1. Link „Zu Google Wallet hinzufügen“ erstellen
Wenn Sie eine Karte oder ein Ticket mit einem „Google Wallet“-Link ausstellen, wird das Karten-/Ticketobjekt dem Google Wallet eines Nutzers hinzugefügt. Dies kann nur im Kontext einer angemeldeten Google-Identität initiiert werden.
Der Link „Zu Google Wallet hinzufügen“ ist eine dynamisch generierte URL, die ein codiertes und signiertes JSON Web Token (JWT) enthält.
Der Link „Zu Google Wallet hinzufügen“ hat folgendes Format:
https://pay.google.com/gp/v/save/<signed_jwt>
Ein vollständig formatierter Link „Zu Google Wallet hinzufügen“ sieht beispielsweise so aus:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
Dieser Link kann in mobile Apps, Websites, E-Mails, Chats, SMS oder an anderen Orten eingebettet werden, die Hyperlinks unterstützen.
Weitere Informationen zum Erstellen von Karten-/Ticketklassen und Karten-/Ticketobjekten finden Sie unter Karten-/Ticketklassen und Karten-/Ticketobjekte erstellen.
Weitere Informationen zum Erstellen des signierten JWT, das zum Erstellen eines Links „Zu Google Wallet hinzufügen“ erforderlich ist, findest du unter Mit JSON Web Tokens arbeiten.
2. (Empfohlen) Schaltfläche „Zu Google Wallet hinzufügen“ verwenden
Auf allen Oberflächen, die Hyperlinks in Bildern unterstützen, z. B. Websites und E‑Mails, wird empfohlen, den Link „Zu Google Wallet hinzufügen“ mit einer Schaltfläche „Zu Google Wallet hinzufügen“ zu präsentieren. Für Google Wallet-Nutzer ist die Schaltfläche eine vertraute Aufforderung, die sie als Möglichkeit erkennen, eine Karte oder ein Ticket zu Google Wallet hinzuzufügen.
Bild-Assets können in verschiedenen Ausrichtungen und Sprachen heruntergeladen werden, um die Integration der Google Wallet API zu unterstützen.