Referência do cliente

A documentação do com.google.android.gms.wallet contém todos os documentos da biblioteca em várias versões da API Google Pay. Veja a seguir um resumo dos objetos e métodos mais aplicáveis à versão mais recente da API Google Pay: versão 2.0.

Carteira

Gere um PaymentsClient para um ambiente de teste ou produção.

Exemplo

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

PaymentsClient

Um cliente para interagir com as APIs do Google Pay.

isReadyToPay(IsReadyToPayRequest)

Use o método isReadyToPay(IsReadyToPayRequest) para determinar a capacidade de um usuário de retornar uma forma de pagamento da API Google Pay.

Se o dispositivo for compatível com o Google Pay e o usuário já tiver salvo uma forma de pagamento ou puder adicionar uma, IsReadyToPay retornará true. Para determinar se o usuário já salvou uma forma de pagamento no Google Pay, defina IsReadyToPayRequest.existingPaymentMethodRequired como true.

loadPaymentData(PaymentDataRequest)

Apresente uma página de pagamento do Google Pay que permite a seleção de uma forma de pagamento e parâmetros configurados opcionalmente.

IsReadyToPayRequest

Crie um objeto Java IsReadyToPayRequest adequado para uso com PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Crie um objeto Java IsReadyToPayRequest de uma string formatada em JSON. Consulte a referência do objeto IsReadyToPayRequest para ver a estrutura esperada da string formatada em JSON fornecida.

PaymentDataRequest

Crie um objeto Java PaymentDataRequest adequado para uso com PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Crie um objeto Java PaymentDataRequest a partir de uma string formatada em JSON. Consulte a referência do objeto PaymentDataRequest para a estrutura esperada da string formatada em JSON fornecida.

PaymentData

Manipule uma resposta formatada em JSON da API Google Pay para uso no seu aplicativo.

toJson()

Saída de uma resposta da API Google Pay como uma string formatada em JSON. Consulte a referência do objeto PaymentData para mais informações sobre a estrutura do objeto JSON.

PayButton

public void initialize(ButtonOption buttonOptions)

O método prático é usado para inicializar um botão de pagamento do Google Pay com a marca mais recente do serviço.

Argumentos

Nome Descrição
buttonOptions Um objeto que configura o botão de pagamento do Google Pay. Consulte ButtonOptions para propriedades configuráveis.

Exemplo: inicialize o botão de pagamento com configurações personalizadas:

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)

O método de conveniência define a visibilidade do botão de pagamento.

Argumentos

Nome Descrição
View

View.VISIBLE define o botão de pagamento como visível (padrão).

View.GONE oculta o botão dos usuários.

Exemplo:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

O método é chamado quando o usuário clica no botão de pagamento do Google Pay.

Argumentos

Nome Descrição
listener Um callback do listener de eventos para chamar quando um evento de clique for entregue ao botão de pagamento do Google Pay.