הפניה ללקוח

בcom.google.android.gms.wallet documentation מופיע תיעוד מלא של הספרייה בכמה גרסאות של Google Pay API. בהמשך מופיע סיכום של אובייקטים ושיטות שרלוונטיים במיוחד לגרסה האחרונה של Google Pay API:‏ גרסה 2.0

Wallet

יוצרים PaymentsClient לסביבת בדיקה או לסביבת ייצור.

דוגמה

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

לקוח ליצירת אינטראקציה עם ממשקי Google Pay API.

isReadyToPay(IsReadyToPayRequest)

משתמשים ב-method‏ isReadyToPay(IsReadyToPayRequest) כדי לקבוע אם למשתמש יש אפשרות להחזיר אמצעי תשלום מ-Google Pay API.

אם המכשיר תומך ב-Google Pay, והמשתמש כבר שמר אמצעי תשלום או יכול להוסיף אמצעי תשלום, IsReadyToPay מחזירה true. כדי לקבוע אם המשתמש כבר שמר אמצעי תשלום ב-Google Pay, צריך להגדיר את IsReadyToPayRequest.existingPaymentMethodRequired לערך true.

loadPaymentData(PaymentDataRequest)

הצגת גיליון תשלום של Google Pay שמאפשר בחירה של אמצעי תשלום ופרמטרים מוגדרים אופציונליים.

IsReadyToPayRequest

יוצרים אובייקט Java שמתאים לשימוש עם PaymentsClient.isReadyToPay().IsReadyToPayRequest

fromJson(java.lang.String)

יוצרים אובייקט IsReadyToPayRequest Java ממחרוזת בפורמט JSON. בחומר העזר בנושא אובייקט IsReadyToPayRequest מוסבר מה המבנה הצפוי של המחרוזת בפורמט JSON.

PaymentDataRequest

פיתוח אובייקט PaymentDataRequest Java שמתאים לשימוש ב-PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

יוצרים אובייקט PaymentDataRequest Java ממחרוזת בפורמט JSON. במאמר בנושא אובייקט PaymentDataRequest מוסבר מה המבנה הצפוי של המחרוזת בפורמט JSON.

PaymentData

טיפול בתגובה בפורמט JSON מ-Google Pay API לשימוש באפליקציה.

toJson()

הפלט של תגובה מ-Google Pay API הוא מחרוזת בפורמט JSON. למידע נוסף על המבנה של אובייקט JSON, אפשר לעיין במאמרי העזרה בנושא אובייקט PaymentData.

PayButton

public void initialize(ButtonOption buttonOptions)

השיטה הנוחה משמשת לאתחול לחצן תשלום ב-Google Pay עם הסגנון של המיתוג העדכני של Google Pay.

ארגומנטים

שם	תיאור
buttonOptions	אובייקט שמגדיר את כפתור התשלום של Google Pay. אפשר לעיין במאמר בנושא ButtonOptions כדי לראות את המאפיינים שניתנים להגדרה.

דוגמה: הפעלה של לחצן התשלום עם הגדרות בהתאמה אישית:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

שיטת הנוחות מגדירה את הנראות של לחצן התשלום.

ארגומנטים

שם	תיאור
View	‫View.VISIBLE מגדיר את לחצן התשלום כגלוי (ברירת מחדל). View.GONE מסתיר את הלחצן מהמשתמשים.

דוגמה:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

השיטה מופעלת כשהמשתמש לוחץ על לחצן התשלום של Google Pay.

ארגומנטים

שם	תיאור
listener	פונקציית קריאה חוזרת (callback) של event listener שמופעלת כשאירוע קליק מועבר ללחצן התשלום של Google Pay.