Wymagania wstępne

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

1. Rejestrowanie konta wydawcy w Portfelu Google API

Do tworzenia i dystrybucji kart z Portfela Google jest wymagane konto wydawcy. Załóż konto wydawcy, rejestrując się w Google Pay i Konsoli Portfela. Po zarejestrowaniu się otwórz stronę Portfela Google i kliknij Utwórz pierwszą kartę. Gdy zaakceptujesz warunki korzystania z usługi, możesz zacząć tworzyć klasę.

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

2. Poznaj tworzenie aplikacji na platformie Android

Na potrzeby tego samouczka zapoznaj się z podstawowymi pojęciami i umiejętnościami dotyczącymi 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 używać interfejsu Google Wallet API na Androida w swojej aplikacji na Androida, musisz autoryzować tę aplikację. Możesz to zrobić za pomocą odcisku cyfrowego SHA1 w kluczu dewelopera i nazwy pakietu.

Aby Twoja aplikacja została zatwierdzona, musisz uzyskać odcisk cyfrowy SHA1 certyfikatu. Aby znaleźć odcisk palca, otwórz okno terminala i uruchom narzędzie Keytool: 

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

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

Narzędzie Keytool pokazuje odcisk cyfrowy w 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. Autoryzowanie aplikacji w Konsoli Google Pay i Portfela Google

Skopiuj odcisk cyfrowy SHA1 wyróżniony w poprzednim przykładzie. Do autoryzacji aplikacji wymagany jest odcisk cyfrowy i nazwa pakietu. Aby autoryzować aplikację, wykonaj te czynności:

  1. Otwórz Konsolę Google Pay i Portfela Google.
  2. Wybierz Google Wallet API w menu po lewej stronie.
  3. Kliknij 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ę
Gdy wykonasz te czynności, Twój pakiet aplikacji zostanie autoryzowany i będzie można go wyświetlić w sekcji Uprawnienia aplikacji.

5. Skonfiguruj Usługi Google Play

Jeśli nie masz jeszcze aplikacji Android Studio, pobierz ją 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.

Aby w szczególności zaimportować interfejs Google Wallet API na Androida, do pliku zależności w module aplikacji dodaj ten blok do pliku build.gradle: 

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

6. Utwórz klasę kart

Przed utworzeniem i dodaniem karty lojalnościowej musisz utworzyć LoyaltyClass. Aby to zrobić, zaloguj się w Konsoli usług Google Pay i Portfela Google, otwórz stronę Google Wallet API i utwórz nowe LoyaltyClass.

  1. Upewnij się, że jesteś na karcie Zarządzaj
  2. Jeśli robisz to po raz pierwszy, zobaczysz komunikat „Jesteś w trybie demonstracyjnym”.
  3. W trybie demonstracyjnym kliknij Skonfiguruj konta testowe, aby dodać konta testowe. Tylko konta tych wydawców będą mogły zapisywać karty w trybie demonstracyjnym.
  4. Kliknij Utwórz zajęcia.
  5. Wybierz Programy lojalnościowe.
  6. Wypełnij wszystkie wymagane pola oznaczone gwiazdką *.
  7. Kliknij Utwórz zajęcia.

Jeśli potrzebujesz więcej kart lojalnościowych, powtórz podane wyżej czynności.

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