Rejestracja kart podarunkowych użytkownika

Funkcja rejestracji (logowania) w programie kart podarunkowych umożliwia użytkownikom wyszukiwanie kart podarunkowych i dodawanie ich do Portfela Google. Użytkownik jest przenoszony na stronę dostosowaną do komórek, na której kończy proces i może dodać kartę do Portfela Google.

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

Omówienie

Sprawdź, czy masz już skonfigurowany projekt z dostępem do interfejsu Google Wallet API.

Aby wdrożyć funkcję logowania się w programie kart podarunkowych, wykonaj te 4 czynności:

1. Skonfiguruj klasę testową w Portfelu Google, aby przetestować proces logowania.
2. Utwórz strony logowania, które korzystają z Portfela Google.SharedDataType
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

Ustaw 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 przeprowadzić weryfikację funkcjonalności implementacji w trakcie procesu tworzenia, skontaktuj się z nami za pomocą widżetu kontaktu z zespołem pomocy w Konsoli Google Pay i Portfela Google. W konsoli w temacie Google Wallet API wybierz Logowanie się za pomocą karty podarunkowej w podtemacie.

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

Gdy użytkownik zdecyduje się dodać kartę podarunkową, zostanie przekierowany na specjalną stronę w Twojej witrynie, na której może dokończyć proces logowania.

Musisz podać adres URL strony logowania, na której użytkownik może zalogować się na istniejące konto.

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 na poziomie 99,9%.

Wyświetlając stronę logowania, Portfel Google tworzy komponent Android WebView, a na podany URL jest wysyłane żądanie POST. 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.

Uwaga: 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. Jest to zgodne ze standardem RFC 3548 (sekcja 4).

Wdrażanie natychmiastowego odsyłania karty podarunkowej do Portfela Google

Po uwierzytelnieniu (zalogowaniu się) użytkownika strona powinna od razu odsyłać kartę podarunkową do Portfela Google.

Uwaga: nie wdrażaj przycisku API Portfela Google, ponieważ użytkownik powinien wrócić do Portfela Google bez dodatkowych działań.

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}

Uwaga: adres URL musi zawierać końcowy znak „/” przed tokenem JWT.

Uwaga: tokeny JWT nie są zaszyfrowane. Precyzyjny link powinien zawierać tylko dane, które można udostępniać jako zwykły tekst.

Bezpieczna długość adresu URL to 2000 znaków. Linki nie powinny jej przekraczać. Obiekty zakodowane w tokenach JWT powinny być małe i zawierać tylko dane dotyczące użytkownika. Utwórz klasę obiektu przed tokenem JWT, aby zapisać w niej większość danych. Jeśli obiekt przekracza limit, spróbuj utworzyć go za pomocą interfejsu API Portfela Google i wysłać w tokenie JWT tylko identyfikator obiektu.

Typowy przepływ komunikacji

Poniżej przedstawiamy przepływ komunikacji podczas logowania się. Wdrożenie wszystkich działań serwera jest Twoim zadaniem.

Prośba o weryfikację i aktywację

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

Po pełnej weryfikacji wdrożenia w aplikacji Portfel Google, która potwierdzi prawidłowe działanie funkcji w połączeniu z aplikacją Portfel Google, funkcja logowania się za pomocą karty podarunkowej będzie publicznie dostępna w Twoim programie kart podarunkowych. Dzięki temu każdy użytkownik zobaczy program i będzie mógł użyć tych funkcji.

Aby zapewnić optymalną wygodę użytkowników, wdrożenie funkcji logowania będzie cyklicznie sprawdzane pod kątem zgodności z wymaganiami. 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. Obrazy powinny być hostowane w lokalizacji z HTTPS. W przeciwnym razie 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 zaleca żadnego konkretnego zewnętrznego rozwiązania.
• Jak zapewniamy poprawną 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. Jest to zgodne ze standardem RFC 3548 (sekcja 4).