Rejestracja kart podarunkowych użytkownika

Funkcja rejestracji (logowania się) przy użyciu karty podarunkowej może wyszukać kartę podarunkową i dodać ją do Portfela Google. Użytkownicy są przekierowywani na Twoją witrynę dostosowaną do komórek, na której wypełnili a następnie dodać kartę do Portfela Google.

Z tego artykułu dowiesz się, jak wdrożyć tę funkcję w Twoim programie kart podarunkowych.

Omówienie

Aby rozpocząć, sprawdź, czy masz już skonfigurowany projekt i czy masz dostęp do Google Wallet API.

Aby wdrożyć funkcję logowania, musisz wykonać te 4 kroki dla swojego programu kart podarunkowych:

  1. Skonfiguruj w Portfelu Google zajęcia testowe, aby przetestować proces logowania.
  2. Twórz strony logowania wykorzystujące SharedDataType Portfela Google.
  3. Wdróż odsyłanie karty podarunkowej do Portfela Google po zalogowaniu się użytkownika.
  4. Poproś o weryfikację i aktywację.

Konfigurowanie zajęć testowych w Portfelu Google

Określ adres URL logowania i logo programu. Następnie użyj zagnieżdżonych pól discoverableProgram w giftcardclass, aby ustawić odpowiednie wartości.

Aby utworzyć wersję roboczą programu kart podarunkowych z obsługą logowania, ustaw wartości w discoverableProgram. Aby mieć pewność, że jest ona widoczna dla testerów, sprawdź, czy testerzy mają dostęp do Twojej Konsoli Google Pay i Portfela Google. Szczegółowe informacje o tym, jak udostępniać dostęp do Konsoli Google Pay i Portfela Google innym osobom, znajdziesz w artykule Więcej informacji o stronie Użytkownicy.

Aby dokończyć weryfikację działania implementacji w trakcie jej tworzenia skontaktuj się z nami za pomocą widżetu kontaktu w Konsoli usług Google Pay i Portfela Google. W domu w konsoli wybierz Google Wallet API w temacie, a następnie Logowanie się za pomocą karty podarunkowej. do podtematu.

Tworzenie strony logowania, która korzysta z danych użytkownika Portfela Google

Gdy użytkownik doda Twoją kartę podarunkową, są przekierowani na odpowiednią stronę w witrynie, aby dokończyć logowania się.

Musisz podać URL logowania, pod którym użytkownik może się zalogować z dotychczasowego konta.

Strona logowania musi spełniać te wymagania:

  • interfejs dostosowany do komórek,
  • możliwość zalogowania się na jednej stronie,
  • szyfrowanie HTTPS z ważnym certyfikatem do bezpiecznego przesyłania danych użytkownika,
  • czas dostępności strony logowania na poziomie 99,9%.

Wyświetlając stronę logowania, Portfel Google utworzy komponent WebView Androida i do podanych przez Ciebie danych wysyłane jest żądanie POST. Adres URL. Dane użytkownika są przesyłane w parametrze SharedDataType, który znajduje się w żądaniu POST używającym typu zawartości application/x-www-form-urlencoded i kodowania UTF-8. Wartością parametru SharedDataType jest obiekt JSON zakodowany w standardzie Base64.

Wdrożenie natychmiastowego odsyłania karty podarunkowej do Portfela Google

Po uwierzytelnieniu (zalogowaniu się) strona natychmiast odesłać kartę podarunkową użytkownika do Portfela Google.

Aby odesłać kartę podarunkową do Portfela Google, przekieruj użytkownika na adres zgodny z poniższą strukturą:

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

Bezpieczna długość adresu URL to 2000 znaków. Linki powinny nie przekraczają tego limitu. Obiekty zakodowane w tokenach JWT powinny być małe i zawierać tylko charakterystycznych dla danego użytkownika. Utwórz klasę obiektu przed tokenem JWT, aby zapisać w niej większość danych. W przypadku większych obiektów, które nie mieszczą się w limicie, weź pod uwagę najpierw tworzymy obiekt w Interfejs Google Wallet API i wysyłając tylko identyfikator obiektu w tokenie JWT.

Typowy przepływ komunikacji

Proces komunikacji użytkownika, który się loguje, został zilustrowany na ten obraz. Wdrożenie wszystkich działań serwera jest Twoim zadaniem.

Procesy logowania

Prośba o weryfikację i aktywację

Po zakończeniu prac programistycznych i przetestowaniu procesu logowania się prześlij prośbę za pomocą widżetu kontaktu z zespołem pomocy w Konsoli Google Pay i Portfela Google.

Po pełnej weryfikacji implementacji i potwierdzeniu poprawności funkcji w połączeniu z aplikacją Portfel Google, logowanie do karty podarunkowej będzie możliwe została udostępniona publicznie w przypadku programu kart podarunkowych. Dzięki temu każdy użytkownik będzie mógł zobaczyć i korzystać z tej funkcji.

Aby zapewnić optymalną wygodę użytkowników, będziemy regularnie sprawdzać Twoje logowanie należy wdrożyć, aby zapewnić stałą zgodność z wymaganiami tej funkcji. W razie rozbieżności otrzymasz powiadomienie, a funkcja logowania może zostać wyłączona do czasu rozwiązania problemu.

Najczęstsze pytania

  • Czy obrazy w moim programie kart podarunkowych muszą spełniać jakieś wymagania?
    • Tak, Twoje zdjęcia powinny być przechowywane w HTTPS lokalizacji ponieważ nie będą widoczne w Portfelu Google.
  • Czy są dostępne narzędzia, które ułatwiają wdrażanie i debugowanie tokenów JWT?
    • Tak. Istnieją platformy, takie jak www.jwt.io, które umożliwiają dekodowanie i debugowanie tokenów podczas programowania. Pozwala to zweryfikować przesyłaną zawartość. Google nie ma powiązania z innymi firmami i nie konkretnie polecić którąkolwiek z tych firm zewnętrznych.
  • Jak zapewniamy prawidłową obsługę danych SharedDataType zakodowanych w standardzie Base64?
    • Sprawdź, czy w całym procesie używasz kodowania UTF-8. Ciąg znaków JSON jest najpierw kodowany w standardzie UTF-8, a następnie android.util.Base64 z opcjami NO_WRAP i URL_SAFE. Odpowiada to RFC 3548 (sekcja 4).