用戶端參考資源

com.google.android.gms.wallet 說明文件包含多個 Google Pay API 版本的程式庫完整說明文件。以下列出最適用於 Google Pay API 最新版 (2.0 版) 的物件和方法總覽。

錢包

為測試或正式版環境產生 PaymentsClient。

範例

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

PaymentsClient

與 Google Pay API 互動的用戶端。

isReadyToPay(IsReadyToPayRequest)

請使用 isReadyToPay(IsReadyToPayRequest) 方法判斷使用者是否能從 Google Pay API 傳回付款方式。

如果裝置支援 Google Pay，且使用者已儲存付款方式，或可新增付款方式，IsReadyToPay 則會傳回 true。如要確認使用者是否已在 Google Pay 中儲存付款方式，請將 IsReadyToPayRequest.existingPaymentMethodRequired 設為 true。

loadPaymentData(PaymentDataRequest)

顯示 Google Pay 付款畫面，允許選取付款方式及選擇設定的參數。

IsReadyToPayRequest

建構適合搭配 PaymentsClient.isReadyToPay() 使用的 IsReadyToPayRequest Java 物件。

fromJson(java.lang.String)

透過 JSON 格式字串建立 IsReadyToPayRequest Java 物件。如需所提供 JSON 格式字串的預期結構，請參閱 IsReadyToPayRequest 物件參考資料。

PaymentDataRequest

建構適合搭配 PaymentsClient.loadPaymentDat 使用的 PaymentDataRequest Java 物件。

fromJson(java.lang.String)

透過 JSON 格式字串建立 PaymentDataRequest Java 物件。如需所提供 JSON 格式字串的預期結構，請參閱 PaymentDataRequest 物件參考資料。

PaymentData

處理 Google Pay API JSON 格式回應，以便在應用程式中使用。

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 點擊事件傳送至 Google Pay 付款按鈕時，要呼叫的事件接聽程式回呼。