Objetos de resposta JSON

Nesta referência, descrevemos as opções de objeto de resposta da API Google Pay para usar com seu aplicativo. Os objetos de resposta são retornados pelos métodos do cliente da API Google Pay.

PaymentData

Esse é um objeto de resposta retornado pelo Google depois que um pagador aprova o pagamento.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Propriedade Tipo Sempre existe Descrição
apiVersion number Sim Versão principal da API. O valor na resposta corresponde ao valor fornecido em
apiVersionMinor número Sim Versão secundária da API. O valor na resposta corresponde ao valor fornecido em
paymentMethodData PaymentMethodData Sim Dados da forma de pagamento selecionada.
email string Não Endereço de e-mail, se emailRequired estiver definido como true no PaymentDataRequest. Essa propriedade não terá efeito se outra solicitação tiver a propriedade definida como true.
shippingAddress Address Não Endereço de entrega, se shippingAddressRequired estiver definido como true no

Exemplo

Neste exemplo de resposta para a API Google Pay versão 2.0, mostramos uma forma de pagamento CARD selecionada na página de pagamento do Google Pay. Um token de forma de pagamento foi gerado para o gateway example.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

Este objeto fornece dados para uma forma de pagamento selecionada.

Propriedade Tipo Sempre existe Descrição
type string Sim PaymentMethod type selecionado na folha de pagamento do Google Pay.
description string Sim

Mensagem direcionada ao usuário para descrever a forma de pagamento que financia essa transação.
info objeto Sim O valor dessa propriedade depende da forma de pagamento type retornada. Para CARD, consulte CardInfo.
tokenizationData PaymentMethodTokenizationData Não Dados de tokenização de pagamento da forma de pagamento selecionada.

Exemplo

Nesta resposta de exemplo, mostramos como uma forma de pagamento CARD selecionada na página de finalização da compra do Google Pay gera um token para o gateway example.

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

Este objeto apresenta informações sobre o cartão de pagamento selecionado.

Propriedade Tipo Sempre existe Descrição
cardDetails string Sim Os detalhes sobre o cartão. Normalmente, esse valor corresponde aos últimos quatro dígitos do número da conta para pagamentos selecionada.
assuranceDetails AssuranceDetailsSpecifications (em inglês) Sim Esse objeto apresenta informações sobre a validação realizada nos dados de pagamento retornados se assuranceDetailsRequired estiver definido como true em CardParameters.
cardNetwork string Sim

A rede do cartão de pagamento do pagamento selecionado. Os valores retornados correspondem ao formato de allowedCardNetworks em CardParameters.

Este valor da rede do cartão não deve ser exibido para o comprador. Ele é usado quando são necessários os dados do cartão de um comprador. Por exemplo, se o suporte ao cliente precisar desse valor para identificar o cartão usado pelo comprador para a transação. Para exibir a descrição ao usuário, use a propriedade description de PaymentMethodData.
billingAddress Address Não O endereço de faturamento associado à forma de pagamento fornecida, se billingAddressRequired estiver definido como true em CardParameters.
cardFundingSource string Sim

Fonte de financiamento do cartão para a forma de pagamento selecionada.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Exemplo

Este exemplo mostra um cartão na rede Visa.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

AssuranceDetailsSpecifications (em inglês)

Esse objeto apresenta informações sobre qual validação foi realizada nas credenciais de pagamento retornadas para que as verificações de risco de instrumento adequadas possam ser aplicadas.

Nome Tipo Descrição
accountVerified booleano Se true, isso indica que a validação de posse de Cardholder foi realizada na credencial de pagamento retornada.
cardHolderAuthenticated booleano

Se true, isso indica que a identificação e as verificações (ID&V) foram realizadas na credencial de pagamento retornada.

Se false, a mesma autenticação com base em risco poderá ser realizada como em transações com cartão. Essa autenticação com base em risco pode incluir, mas não se limita a, autenticação por etapas com o protocolo 3D Secure, se aplicável.

Você pode receber e processar o objeto de resposta mesmo que não use o campo assuranceDetails. Para receber esse objeto, inclua assuranceDetailsRequired: true nos CardParameters.

PaymentMethodTokenizationData

Este objeto fornece dados de tokenização para a forma de pagamento.

Propriedade Tipo Sempre existe Descrição
type string Sim O tipo de tokenização a ser aplicado à forma de pagamento selecionada. Esse valor corresponde ao type definido em PaymentMethodTokenizationSpecification.
token string Não

O token gerado da forma de pagamento.

Exemplo

Este é um exemplo de uma resposta tokenizada preparada para o gateway example.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

PaymentAuthorizationResult

Este objeto apresenta informações sobre o resultado da autorização de pagamento.

Propriedade Tipo Necessidade Descrição
transactionState String Obrigatório O estado da transação é resolvido por um dos seguintes resultados do comerciante:
  • SUCCESS
  • ERROR
error PaymentDataError Opcional O erro exibido ao usuário na página de pagamento quando for necessário repetir a transação.

Exemplo

O exemplo a seguir mostra o retorno do resultado do pagamento após o processamento dele:

{
  "transactionState": "ERROR",
  "error": {
    "reason": "PAYMENT_DATA_INVALID",
    "message": "Cannot pay with payment credentials",
    "intent": "PAYMENT_AUTHORIZATION"
  }
}

PaymentDataError

Propriedade Tipo Necessidade Descrição
reason String Obrigatório

Lista de motivos de erro predefinidos:

  • PAYMENT_DATA_INVALID
  • SHIPPING_ADDRESS_INVALID
  • SHIPPING_ADDRESS_UNSERVICEABLE
  • SHIPPING_OPTION_INVALID
  • OTHER_ERROR
message String Obrigatório Mensagem de erro para o usuário exibida em uma caixa de diálogo.
intent String Obrigatório

A intenção do erro.

  • PAYMENT_AUTHORIZATION
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION

Exemplo

Este exemplo mostra o intent do erro e a mensagem a ser renderizada na página de pagamento.

{
  "error": {
    "reason": "SHIPPING_OPTION_INVALID",
    "message": "This shipping option is invalid for the given address",
    "intent": "SHIPPING_OPTION"
  }
}

Address

Este objeto fornece informações sobre um endereço postal solicitado. Todas as propriedades são strings.

Os endereços podem ser retornados nos formatos MIN, FULL e FULL-ISO3166. As propriedades de cada formato podem ser vistas na tabela a seguir.

Propriedade Formato do endereço Descrição
name MIN, FULL, FULL-ISO3166 O nome completo do destinatário.
postalCode MIN, FULL, FULL-ISO3166 O código postal ou CEP.
countryCode MIN, FULL, FULL-ISO3166 Código do país de acordo com a norma ISO 3166-1 alfa-2.
phoneNumber MIN, FULL, FULL-ISO3166 Um número de telefone, se phoneNumberRequired estiver definido como true no PaymentDataRequest.
address1 FULL, FULL-ISO3166 A primeira linha do endereço.
address2 FULL, FULL-ISO3166 A segunda linha do endereço.
address3 FULL, FULL-ISO3166 A terceira linha do endereço.
locality FULL, FULL-ISO3166 Cidade, município, bairro ou subúrbio.
administrativeArea FULL, FULL-ISO3166 Uma subdivisão de país, como um estado ou província.
sortingCode FULL, FULL-ISO3166 O código de classificação.
iso3166AdministrativeArea FULL-ISO3166 Código da área político-administrativa ISO 3166-2 correspondente a "administrativeArea".

Exemplo

Este é um exemplo de endereço no formato FULL-ISO3166 nos Estados Unidos com várias linhas de dados.

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}

IntermediatePaymentData

Esse objeto é retornado pela entrada onPaymentDataChanged() da API Google Pay quando o endereço de entrega ou as opções de envio são alteradas na página de pagamento.

Propriedade Tipo Necessidade Descrição
callbackTrigger String Opcional

Descreve o motivo pelo qual o callback dos dados de pagamento foi invocado.

  • INITIALIZE
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION
shippingAddress IntermediateAddress Opcional O endereço selecionado na página de pagamento.
shippingOptionData SelectionOptionData Opcional A opção de envio selecionada na página de pagamento.

Exemplo

Este exemplo mostra o payload intermediário retornado pela API Google Pay.

{
  "callbackTrigger": "SHIPPING_ADDRESS",
  "shippingAddress": {
    "administrativeArea": "NY",
    "countryCode": "US",
    "locality": "New York",
    "postalCode": "10011"
  },
  "shippingOptionData": {
    "id": "shipping-001"
  }
}

IntermediateAddress

O endereço intermediário contém um endereço de entrega editado (sem linhas de endereço no nível da rua ou nomes de destinatários) para permitir o cálculo do tributo e das opções de frete aplicáveis antes que o usuário autorize o pagamento.

Propriedade Tipo Necessidade Descrição
administrativeArea String Obrigatório Uma subdivisão de país, como um estado ou província.
countryCode String Obrigatório Código do país de acordo com a norma ISO 3166-1 alfa-2.
locality String Obrigatório Cidade, município, bairro ou subúrbio.
postalCode String Obrigatório O código postal editado de acordo com o país. Para o Canadá e o Reino Unido, essa informação contém apenas os três primeiros caracteres. Para os Estados Unidos, ela contém os cinco primeiros dígitos.
iso3166AdministrativeArea String Opcional Código da área político-administrativa ISO 3166-2 correspondente a "administrativeArea". Presente somente se o formato do endereço de entrega for FULL-ISO3166.

Exemplo

Este exemplo mostra o endereço selecionado na página de pagamento.

{
  "administrativeArea": "NY",
  "countryCode": "US",
  "locality": "New York",
  "postalCode": "10011"
  "iso3166AdministrativeArea": "US-NY"
}

SelectionOptionData

Propriedade Tipo Necessidade Descrição
id String Obrigatório Corresponde a SelectionOption.id

Exemplo

Este exemplo mostra a opção de envio selecionada na página de pagamento.

{
  "id": "shipping-001"
}