Wymagania wstępne

Zanim rozpoczniesz integrację z Google Wallet API, wykonaj te czynności:

1. Załóż konto Google Wallet API Issuer

Do tworzenia i dystrybucji kart do Portfela Google wymagane jest konto wydawcy. Aby uzyskać swoje konto wydawcy, zarejestruj się w Konsoli usług Google Pay i Portfela Google. Po rejestracji otwórz stronę Google Wallet API i kliknij Utwórz swój pierwszy bilet. Po zaakceptowaniu warunków usługi możesz zacząć tworzyć klasę karty.

Po wykonaniu powyższego kroku możesz też wypróbować ćwiczenia z programowania.

2. Poznaj tworzenie aplikacji na platformie Android

W tym samouczku zapoznaj się z podstawowymi pojęciami i umiejętnościami tworzenia aplikacji na platformę Android. Jeśli przed rozpoczęciem chcesz uzyskać informacje o programowaniu aplikacji na Androida, weź udział w szkoleniach dla deweloperów aplikacji na Androida.

3. Uzyskiwanie danych logowania do autoryzacji aplikacji

Aby korzystać z interfejsu Google Wallet API na Androida w swojej aplikacji na Androida, musisz ją autoryzować. Aby to zrobić, użyj odcisku cyfrowego SHA1 w kluczu programisty i nazwy pakietu.

Aby uzyskać zatwierdzenie aplikacji, musisz uzyskać odcisk cyfrowy SHA1 certyfikatu. Aby znaleźć odcisk cyfrowy, otwórz okno terminala i uruchom narzędzie Keytool: 

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

Magazyn kluczy debugowania znajduje się zwykle w ~/.android/debug.keystore, a jego hasło to android.

Keytool wyświetla odcisk palca na powłoce. Na przykład: 

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

4. Autoryzuj aplikację w Konsoli usług Google Pay i Portfela Google

Skopiuj odcisk cyfrowy SHA1, który jest wyróżniony w poprzednim przykładzie. Do autoryzacji aplikacji potrzebny jest odcisk cyfrowy i nazwa pakietu. Aplikację można autoryzować, wykonując te czynności:

  1. Otwórz Konsolę Google Pay i Portfela Google.
  2. Wybierz Google Wallet API z menu po lewej stronie.
  3. Wybierz kartę Dodatkowe funkcje.
  4. Przewiń w dół do sekcji Uprawnienia aplikacji.
  5. Kliknij przycisk Dodaj aplikację
  6. Wpisz nazwę pakietu i odcisk cyfrowy klucza podpisu
  7. Kliknij przycisk Dodaj aplikację
Po wykonaniu tych czynności Twój pakiet aplikacji zostanie autoryzowany. Możesz go teraz wyświetlić w sekcji Uprawnienia aplikacji.

5. Skonfiguruj Usługi Google Play

Jeśli nie masz jeszcze środowiska Android Studio, pobierz i zainstaluj Android Studio.

Portfel Google na Androida jest częścią Usług Google Play. Aby zaimportować biblioteki Usług Google Play, wykonaj instrukcje konfigurowania Usług Google Play.

Jeśli chcesz zaimportować interfejs API Portfela Google na Androida, dodaj ten fragment do bloku zależności do pliku build.gradle w module aplikacji: 

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

6. Utwórz klasę kart

Zanim utworzysz i dodasz bilet na wydarzenie, musisz utworzyć EventClass. Aby to zrobić, zaloguj się w Konsoli usług Google Pay i Portfela Google, otwórz stronę Google Wallet API i utwórz nowy identyfikator EventClass.

  1. Otwórz kartę Zarządzaj.
  2. Jeśli po raz pierwszy tworzysz kartę, powinien pojawić się komunikat „Jesteś w trybie demonstracyjnym”.
  3. W trybie demonstracyjnym kliknij „Skonfiguruj konta testowe”, aby dodać konta testowe. Gdy konto wydawcy jest w trybie demonstracyjnym, tylko te konta będą mogły zapisywać karty.
  4. Kliknij Utwórz zajęcia.
  5. Wybierz Wydarzenie.
  6. wypełnij wszystkie wymagane pola oznaczone symbolem *;
  7. Kliknij Utwórz zajęcia.

Powtórz czynności opisane powyżej, jeśli potrzebujesz kilku biletów na wydarzenia.

Po utworzeniu karty EventClass możesz przejść do dodawania kart do Portfela Google.