客户端参考文档

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.loadPaymentData 的 PaymentDataRequest Java 对象。

fromJson(java.lang.String)

根据 JSON 格式字符串创建 PaymentDataRequest Java 对象。如需了解所提供的 JSON 格式字符串的预期结构，请参阅 PaymentDataRequest 对象参考文档。

PaymentData

处理 Google Pay API JSON 格式的响应，以供您的应用使用。

toJson()

以 JSON 格式字符串输出 Google Pay API 响应。如需详细了解 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 付款按钮时调用的事件监听器回调。