پیش نیازها

قبل از اینکه بتوانید ادغام با Google Wallet API را شروع کنید، مراحل زیر را انجام دهید:

1. برای یک حساب Google Wallet API Issuer ثبت نام کنید

برای ایجاد و توزیع مجوزهای Google Wallet، یک حساب صادرکننده لازم است. با ثبت نام در Google Pay و Wallet Console حساب صادرکننده خود را دریافت کنید. پس از ثبت نام، به صفحه Google Wallet API بروید و روی ساخت اولین مجوز خود کلیک کنید. هنگامی که شرایط خدمات را پذیرفتید، می توانید شروع به ایجاد یک کلاس عبور کنید.

پس از مرحله بالا می توانید Codelab را نیز امتحان کنید.

2. با توسعه اپلیکیشن در پلتفرم اندروید آشنا شوید

برای اهداف این آموزش، با مفاهیم اولیه و مهارت های توسعه اپلیکیشن برای پلتفرم اندروید آشنا شوید. اگر قبل از شروع نیاز دارید درباره توسعه Android بیاموزید، چند درس را در آموزش برنامه‌نویسان Android مطالعه کنید.

3. برای تأیید مجوز برنامه خود، اعتبارنامه دریافت کنید

برای استفاده موفقیت آمیز از Google Wallet API برای Android در برنامه Android خود، باید برنامه خود را تأیید کنید. می توانید این کار را با اثر انگشت SHA1 در کلید توسعه دهنده خود و نام بسته انجام دهید.

برای تأیید درخواست خود، باید اثر انگشت SHA1 گواهی را دریافت کنید. برای پیدا کردن اثر انگشت، یک پنجره ترمینال را باز کنید و ابزار Keytool را اجرا کنید:

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

فروشگاه کلید اشکال زدایی معمولاً در ~/.android/debug.keystore و رمز عبور آن android است.

Keytool اثر انگشت را روی پوسته چاپ می کند. مثلا:

$ 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

اثر انگشت SHA1 را که در مثال قبل مشخص شده است کپی کنید. اثر انگشت و نام بسته برنامه برای تأیید مجوز برنامه مورد نیاز است. برنامه را می توان با تماس با تیم پشتیبانی از طریق ابزارک پشتیبانی تماس با کنسول کسب و کار مجاز کرد.

4. سرویس های Google play را راه اندازی کنید

اگر قبلاً Android Studio را ندارید، Android Studio را دانلود و نصب کنید.

Google Wallet برای Android بخشی از خدمات Google Play است. برای وارد کردن کتابخانه‌های خدمات Google Play، دستورالعمل‌های راه‌اندازی خدمات Google Play را دنبال کنید.

به ویژه، برای وارد کردن Google Wallet API برای Android، موارد زیر را به بلوک وابستگی ها به فایل build.gradle در ماژول برنامه اضافه کنید:

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

5. یک کلاس پاس ایجاد کنید

قبل از اینکه بتوانید یک کارت وفاداری ایجاد و اضافه کنید، ابتدا باید یک LoyaltyClass ایجاد کنید. این کار را می توان با ورود به Google Pay و Wallet Console ، پیمایش به صفحه Google Wallet API و ایجاد یک LoyaltyClass جدید انجام داد.

  1. مطمئن شوید که در برگه مدیریت هستید
  2. اگر این اولین باری است که مجوز ایجاد می‌کنید، باید «شما در حالت نمایشی هستید» را ببینید.
  3. در حالت نمایشی، برای افزودن حساب‌های آزمایشی، روی «تنظیم حساب‌های آزمایشی» کلیک کنید. زمانی که حساب صادرکننده شما در حالت نمایشی است، فقط این حساب‌ها می‌توانند مجوزها را ذخیره کنند.
  4. روی Create a class کلیک کنید
  5. وفاداری را انتخاب کنید
  6. پر کردن تمام فیلدهای اجباری با علامت *
  7. روی Create class کلیک کنید

اگر به چندین کارت وفاداری نیاز دارید، مراحل بالا را تکرار کنید.

اکنون که با موفقیت یک LoyaltyClass ایجاد کرده اید، می توانید به افزودن مجوز به Google Wallet بروید.