Registrierung von Nutzergutscheinen

Mit der Funktion zur Registrierung von Geschenkkarten (Anmeldung) können Nutzer Geschenkkarte und fügen Sie sie Google Wallet hinzu. Nutzer werden auf die für Mobilgeräte optimierte Website weitergeleitet, um den Vorgang abzuschließen. Anschließend können sie ihre Karte ganz einfach zu Google Wallet hinzufügen.

Dieser Leitfaden bietet einen Überblick über die erforderlichen Implementierungsschritte. um Ihr Geschenkkartenprogramm für diese Funktion zu aktivieren.

Übersicht

Vergewissern Sie sich zuerst, dass Sie bereits ein Projekt eingerichtet und Zugriff auf die Google Wallet API haben.

Führen Sie die folgenden vier Schritte aus, um die Anmeldefunktion für das Geschenkkartenprogramm einzubinden:

  1. Richte in Google Wallet einen Testkurs ein, um die Anmeldung zu testen.
  2. Erstellen Sie Anmeldeseiten, auf denen Google Wallet SharedDataType verwendet wird.
  3. Implementieren Sie die Rückgabe der Geschenkkarte in Google Wallet nach der Anmeldung.
  4. Fordern Sie die Bestätigung und Aktivierung an.

Testklasse in Google Wallet einrichten

Bestimme die Anmelde-URL, dein Programmlogo. Gehen Sie dann so vor: Verwenden Sie die verschachtelten Felder discoverableProgram in der giftcardclass zum Festlegen des geeignete Werte.

Legen Sie die Werte im discoverableProgram fest, um einen Entwurf der Registrierung/Anmeldung für das Geschenkkartenprogramm zu erstellen. Damit dies für Tester sichtbar ist, musst du prüfen, Die Tester haben Zugriff auf deine Google Pay & Wallet Console. Weitere Informationen dazu, wie Sie anderen Nutzern Zugriff auf die Google Pay and Wallet Console geben, finden Sie unter Weitere Informationen zur Seite „Nutzer“.

Um die Überprüfung der Funktionalität Ihrer Implementierung während der Entwicklung abzuschließen kannst du dich über das Kontakt-Support-Widget in der Google Pay and Wallet Console an uns wenden. Im Wähle in der Console als Thema Google Wallet API und dann Anmeldung mit Geschenkkarte aus. untergeordnetes Thema.

Anmeldeseite entwickeln, auf der Google Wallet-Nutzerdaten verwendet werden

Wenn ein Nutzer Ihre Geschenkkarte hinzufügen möchte, wird er auf eine speziell dafür vorgesehene Seite Ihrer Website weitergeleitet, auf der er den Anmeldevorgang abschließen kann.

Sie müssen eine Anmelde-URL angeben, unter der sich ein Nutzer anmelden kann. in einem bestehenden Konto.

Ihre Anmeldeseite muss die folgenden Anforderungen erfüllen:

  • Bieten Sie eine für Mobilgeräte optimierte Nutzererfahrung.
  • Der Nutzer kann sich auf einer einzigen Seite anmelden.
  • Verwenden Sie die HTTPS-Verschlüsselung mit einem gültigen Zertifikat, damit die Nutzerdaten sicher übertragen werden.
  • Sorgen Sie dafür, dass Ihre Anmeldeseite zu mindestens 99,9% verfügbar ist.

Bei der Präsentation der Anmeldeseite erstellt Google Wallet eine Android WebView und eine POST-Anfrage wird an die bereitgestellte URL Nutzerdaten werden im Parameter SharedDataType bereitgestellt. Dieser Parameter ist in der POST-Anfrage mit dem Inhaltstyp application/x-www-form-urlencoded und UTF-8-Codierung enthalten. Der Wert von SharedDataType ist ein Base64-codiertes JSON-Objekt.

Sofortige Ablehnung der Geschenkkarte in Google Wallet implementieren

Nach der Authentifizierung (Anmeldung) sollte Ihre Seite die Geschenkkarte des Nutzers sofort an Google Wallet zurückgeben.

Sie können die Geschenkkarte an Google Wallet zurücksenden, indem Sie der der Struktur folgt,

https://pay.google.com/gp/v/save/{jwt_generated}

Die sichere Länge einer URL beträgt 2.000 Zeichen. Ihre Links sollten dieses Limit nicht überschreiten. In JWTs codierte Objekte sollten klein sein und nur Daten enthalten, die für den Nutzer spezifisch sind. Die meisten Daten sollten in der Klasse des Objekts verbleiben, das vor dem JWT erstellt wird. Bei größeren Objekten, die das Limit überschreiten, sollte das Objekt zuerst in der Google Wallet API erstellt und im JWT nur die Objekt-ID gesendet werden.

Typischer Kommunikationsablauf

Der Kommunikationsablauf für einen Nutzer, der die Anmeldung durchführt, ist in der folgenden Bild. Alle Aktionen zwischen „Ihr Server“ für deren Umsetzung Sie verantwortlich sind.

Anmeldeabläufe

Überprüfung und Aktivierung anfordern

Nachdem Sie die Entwicklungsarbeit abgeschlossen und den Anmeldevorgang getestet haben, senden Sie über das Support-Widget der Google Pay and Wallet Console eine Anfrage.

Nach einer vollständigen Überprüfung deiner Implementierung, mit der die korrekte Funktionsweise in Verbindung mit der Google Wallet-App bestätigt wird, erfolgt die offizielle Einführung der Anmeldefunktion für dein Geschenkkartenprogramm. Somit kann jeder Nutzer das Programm sehen und diese Funktion nutzen.

Ihre Anmeldeimplementierung wird immer wieder überprüft, um die fortlaufende Einhaltung der Funktionsanforderungen sicherzustellen. So wird für eine optimale Nutzererfahrung gesorgt. Bei Abweichungen werden Sie entsprechend benachrichtigt. Die Anmeldefunktion wird möglicherweise deaktiviert, bis das Problem behoben ist.

Häufig gestellte Fragen

  • Gibt es Anforderungen an die in meinem Geschenkkartenprogramm verwendeten Bilder?
    • Ja, Ihre Bilder sollten am Standort HTTPS gehostet werden, da sie ansonsten in Google Wallet nicht sichtbar sind.
  • Gibt es Tools für eine einfachere Implementierung und Fehlerbehebung von JWTs?
    • Ja, Plattformen wie www.jwt.io ermöglicht es Ihnen, und Fehler während des Entwicklungsprozesses beheben, der von Ihnen eingereichten Inhalte. Beachten Sie, dass Google weder mit Google Dritten ausdrücklich empfehlen.
  • Wie werden die Base64-codierten SharedDataType-Daten richtig verarbeitet?
    • Verwenden Sie während des gesamten Prozesses die UTF-8-Codierung. Der JSON-String wird zuerst mit UTF-8 und anschließend mit android.util.Base64 mit den Optionen NO_WRAP und URL_SAFE codiert. Dies entspricht Abschnitt 4 von RFC 3548.