Ön koşullar

Google Cüzdan API'si ile entegrasyona başlamadan önce aşağıdaki adımları tamamlayın:

1. Google Cüzdan API'si Düzenleyen hesabı için kaydolma

Kartı veren kuruluşun Google Cüzdan için kart oluşturup dağıtması gerekir. Google Pay ve Cüzdan Konsolu'na kaydolarak kartı veren kuruluşa ait hesabı edinin. Kaydolduktan sonra Google Cüzdan API'si sayfasına gidin ve İlk kartınızı oluşturun'u tıklayın. Hizmet şartlarını kabul ettikten sonra bir şifre sınıfı oluşturmaya başlayabilirsiniz.

Yukarıdaki adımdan sonra Codelab'i de deneyebilirsiniz.

2. Android platformunda uygulama geliştirme hakkında bilgi edinin

Bu eğitimin amacı doğrultusunda, Android platformu için uygulama geliştirmeyle ilgili temel kavramları ve becerileri öğrenin. Başlamadan önce Android geliştirme hakkında bilgi edinmeniz gerekiyorsa Android Geliştiricileri Eğitimi kursuna göz atın.

3. Uygulamanızı yetkilendirmek için kimlik bilgilerini alma

Android uygulamanızda Google Cüzdan API'sini Android uygulamanızda başarılı bir şekilde kullanmak için uygulamanızı yetkilendirmeniz gerekir. Bunu, geliştiricinizin anahtarındaki ve paket adındaki SHA1 parmak iziyle yapabilirsiniz.

Başvurunuzla ilgili onay almak için sertifikanın SHA1 parmak izini almanız gerekir. Parmak izini bulmak için bir terminal penceresi açın ve Keytool yardımcı programını çalıştırın: 

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

Hata ayıklama anahtar deposu genellikle ~/.android/debug.keystore adresinde bulunur ve anahtarın şifresi android şeklindedir.

Keytool, parmak izini kabuğuna yazdırır. Örneğin: 

$ 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. Uygulamanızı Google Pay ve Cüzdan Konsolu'nda yetkilendirme

Önceki örnekte vurgulanan SHA1 parmak izini kopyalayın. Uygulamanın yetkilendirilmesi için parmak izi ve paket adı gereklidir. Uygulama aşağıdaki adımları tamamlayarak yetkilendirilebilir:

  1. Google Pay ve Cüzdan Konsolu'na gidin
  2. Soldaki menüden Google Cüzdan API'si seçeneğini belirleyin.
  3. Ek özellikler sekmesini seçin.
  4. Uygulama izinleri bölümüne ilerleyin
  5. Uygulama ekle düğmesini tıklayın.
  6. Paketinizin adını ve imza anahtarı dijital parmak izini girin
  7. Uygulama ekle düğmesini tıklayın.
Bu adımlar tamamlandıktan sonra, uygulama paketiniz yetkilendirilmiş olur. Uygulama paketinizi Uygulama izinleri bölümünde görebilirsiniz.

5. Google Play Hizmetleri'ni ayarlama

Henüz Android Studio'nuz yoksa Android Studio'yu indirip yükleyin.

Android için Google Cüzdan, Google Play Hizmetleri'nin bir parçasıdır. Google Play Hizmetleri kitaplıklarını içe aktarmak için Google Play Hizmetleri'ni ayarlama talimatlarını uygulayın.

Android için Google Cüzdan API'sini içe aktarmak amacıyla aşağıdaki öğeleri uygulama modülündeki build.gradle dosyasına bağımlılıklar bloğuna ekleyin: 

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

6. Kartlar Sınıfı Oluştur

Hediye kartı oluşturup ekleyebilmeniz için önce bir GiftCardClass oluşturmanız gerekir. Bunu yapmak için Google Pay ve Cüzdan Konsolu'nda oturum açın, Google Cüzdan API'si sayfasına gidin ve yeni bir GiftCardClass oluşturun.

  1. Yönet sekmesinde olduğunuzdan emin olun
  2. İlk kez kart oluşturuyorsanız "Demo modundasınız" ifadesini görürsünüz.
  3. Demo modundayken test hesabı eklemek için "Test hesapları oluştur"u tıklayın. Kartı veren kuruluş hesabınız demo modundayken yalnızca bu hesaplar kartları kaydedebilir.
  4. Sınıf oluştur'u tıklayın
  5. Hediye Kartı'nı seçin
  6. * ile işaretlenen tüm zorunlu alanları doldurun
  7. Sınıf oluştur'u tıklayın

Birden fazla hediye kartına ihtiyacınız varsa yukarıdaki adımları tekrarlayın.

Artık GiftCardClass oluşturduğunuza göre Google Cüzdan'a kart ekleme adımına geçebilirsiniz.