Po utworzeniu karty i zakodowaniu jej w podpisanym tokenie JWT możesz ją wydać wszędzie tam, gdzie obsługiwany jest link „Dodaj do Portfela Google”. Aby to zrobić, musisz wyświetlić użytkownikowi przycisk „Dodaj do Portfela Google” lub hiperlink, który po kliknięciu zapisze kartę w Portfelu Google. Możesz użyć tej metody na przykład w aplikacjach mobilnych, witrynach, e-mailach, czatach i SMS-ach.
Wymagania wstępne
Zanim spróbujesz wydać kartę, wykonaj te czynności:
- Wykonaj wszystkie czynności opisane w przewodniku po procesie wdrażania.
- utworzyć co najmniej jedną klasę kart,
- Utwórz co najmniej 1 obiekt karty.
- Zakoduj klasę i obiekt kart w tokenie JWT.
- Podpisz token JWT kluczem konta usługi Google Cloud.
1. Tworzenie linku „Dodaj do Portfela Google”
Wydanie karty za pomocą linku „Portfel Google” powoduje dodanie obiektu karty do Portfela Google użytkownika i może zostać zainicjowane tylko w kontekście zalogowanej tożsamości Google.
Link „Dodaj do Portfela Google” to dynamicznie generowany adres URL, który zawiera zakodowany i podpisany token sieciowy JSON (JWT).
Link Dodaj do Portfela Google ma ten format:
https://pay.google.com/gp/v/save/<signed_jwt>
Na przykład w pełni sformułowany link „Dodaj do Portfela Google” będzie wyglądać mniej więcej tak:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
Ten link można umieścić w aplikacjach mobilnych, witrynach, e-mailach, czatach, SMS-ach lub w dowolnym innym miejscu, które obsługuje hiperlinki.
Więcej informacji o tworzeniu klas i obiektów kart znajdziesz w artykule Tworzenie klas i obiektów kart.
Więcej informacji o tworzeniu podpisanego tokena JWT potrzebnego do utworzenia linku „Dodaj do Portfela Google” znajdziesz w artykule Praca z tokenami sieciowymi JSON.
2. (Zalecane) Używanie przycisku „Dodaj do Portfela Google”
W przypadku platform, które obsługują hiperlinki do obrazów, takich jak witryny i e-maile, zalecamy wyświetlanie użytkownikom linku „Dodaj do Portfela Google” za pomocą przycisku „Dodaj do Portfela Google”. Dla użytkowników Portfela Google przycisk jest znajomym elementem, który rozpoznają jako sposób na rozpoczęcie dodawania karty do Portfela Google.
Komponenty z obrazem są dostępne do pobrania w różnych orientacjach i językach, aby ułatwić integrację z interfejsem Google Wallet API.