SCA e a API Google Pay

Importante: as transações de pagamento on-line processadas nos países do Espaço Econômico Europeu (EEE) devem obedecer aos requisitos da Autenticação Segura do Cliente (SCA, na sigla em inglês), de acordo com a segunda Diretiva Europeia de Serviços de Pagamento (PSD2, na sigla em inglês).

Autenticação Segura do Cliente

Observação: as versões anteriores da API Google Pay não são compatíveis com os recursos a seguir. Atualize para a versão mais recente.

Para permitir que o Google Pay retorne as credenciais de pagamento apropriadas em transações sujeitas à Autenticação Segura do Cliente (SCA), talvez seja necessário atualizar sua implementação.

Se você tiver concluído a integração da API Google Pay V2, as seguintes alterações serão necessárias.

Atualizar o objeto PaymentDataRequest

Atualize o objeto PaymentDataRequest com as seguintes propriedades:

• merchantInfo.merchantName : o nome do comerciante é renderizado na folha de pagamento.
• transactionInfo.countryCode : indica onde a transação é processada. É preciso especificar o país do banco do adquirente.
• transactionInfo.totalPrice : o valor monetário total da transação, com uma precisão decimal opcional de duas casas decimais.

Exemplo de objeto PaymentDataRequest atualizado

Veja a seguir o exemplo de um objeto PaymentDataRequest atualizado:

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "merchantInfo": {
    "merchantName": "Example Merchant"
  },
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
        "allowedCardNetworks": ["AMEX", "DISCOVER", "INTERAC", "JCB", "MASTERCARD", "VISA"]
      },
      "tokenizationSpecification": {
        "type": "PAYMENT_GATEWAY",
        "parameters": {
          "gateway": "example",
          "gatewayMerchantId": "exampleGatewayMerchantId"
        }
      }
    }
  ],
  "transactionInfo": {
    "totalPriceStatus": "FINAL",
    "totalPrice": "12.34",
    "countryCode": "GB",
    "currencyCode": "GBP"
  }
}

Processar o objeto de resposta

Os comerciantes recebem um dos itens a seguir:

• Um payload autenticado que pode ser processado sem mais etapas ou desafios.
• Um PAN que requer o 3D Secure 2.0 por meio de uma solução fornecida internamente ou por meio de parceiros de provedores de serviços de pagamento (PSP, na sigla em inglês).

A maioria dos nossos PSPs oferece a capacidade de fazer verificações de risco de instrumentos apropriadas e transações de acompanhamento. Quando aplicável, isso inclui 3D Secure para transações PAN PAN_ONLY do Google Pay.

Se você tiver uma ferramenta de gerenciamento de riscos interna, use o parâmetro assuranceDetailsRequired para mais detalhes sobre as transações para criar um anexo da VLAN de monitoramento.

Se assuranceDetails.cardHolderAuthenticated retornar false, aplique as verificações de risco do instrumento e transações de acompanhamento apropriadas. Quando aplicável, inclua o 3D Secure.