API Transaction Events

Neste guia, apresentamos detalhes para ajudar os desenvolvedores a notificar o Google sobre as informações de transação do Google Pay. Depois que um usuário confirma uma transação do Google Pay, a API Transaction Events notifica o Google sobre o pagamento e os eventos relacionados a pedidos. O uso da API Transaction Events nos ajuda a tomar decisões de risco antecipadamente e complementa as verificações de risco do comerciante.

Alterações necessárias da API

Para configurar callbacks para a API, siga as etapas abaixo:

Preencha o campo transactionInfo.transactionId em PaymentDataRequest.

É necessário criar um ID exclusivo para essa tentativa de transação Sugerimos usar um ID existente que você já tenha para representar essa tentativa de transação. Caso não tenha um disponível, é possível gerar um específico para ser armazenado pelas tentativas de transações do Google Pay no seu sistema.
Crie uma Conta do Google genérica.

Compartilhe a conta internamente com sua equipe e com o Google para que ela seja adicionada à nossa lista de permissões. O gerente de conta pode ajudar com esse processo, mas não pode criar a conta para você. Não dê acesso a essa Conta do Google para ele.
Crie um projeto do Google Cloud.

Depois que o Google conceder acesso à Conta do Google do desenvolvedor, o operador precisará fazer login com essa conta e acessar o Console do Google Cloud. O desenvolvedor precisa criar um projeto para essa integração. Não crie outros projetos com a mesma Conta do Google usada para criar esse projeto.
Crie uma nova conta do Cloud Billing ou confirme se o faturamento está ativado no seu projeto.
Ative a API Transaction Events com a API VGW.

A API Transaction Events está sob o conjunto de APIs VGW. Para acessar o endpoint específico necessário, ative a API VGW no seu projeto. Para isso, ative o Cloud Shell no Google Cloud Platform e execute o seguinte comando na linha de comando:
```
gcloud services enable vgw.googleapis.com
```
No seu projeto, crie e registre uma conta de serviço.

Crie uma conta de serviço e notifique seu contato do Google com o endereço de e-mail associado à conta de serviço. Isso vincula a conta de serviço ao perfil de comerciante. Leva cerca de um dia útil para adicionar sua conta de serviço à lista de permissões.
Depois que concedermos acesso à sua conta de serviço, conclua as etapas a seguir para fazer uma chamada de API autorizada:
1. Use o token de curta duração em uma solicitação subsequente para a API Transaction Events.
  
  O arquivo de entrada é a chave JSON particular criada com a conta de serviço. O escopo é o seguinte:
```
https://www.googleapis.com/auth/facilitated.transaction.event.service
```
2. Crie o corpo da solicitação da notificação de evento.
  
  Existem nove tipos de evento, como AuthorizationSucceeded e AuthorizationDeclined. Crie a solicitação da notificação de evento relevante.
3. Envie uma notificação de evento sobre uma transação. Para isso, siga os passos abaixo:
  1. Faça uma solicitação HTTP para o URL a seguir:
```
https://billpaynotification.googleapis.com/secure-serving/gsp/v2/facilitatedTransaction/eventNotification/{merchant_id}
```
  2. Transmita o token OAuth no cabeçalho da seguinte forma:
    
    Authorization: Bearer {token}.
  3. Verifique se o merchant_id na sua solicitação corresponde ao valor do seu ID de comerciante no Console Business do Google Pay.
Verifique se a solicitação atende aos seguintes critérios:
- Cada solicitação precisa ter um requestId exclusivo.
- O requestTimestamp não pode ser maior que 60 segundos no passado ou no futuro a partir do horário atual.
  
  Observação: requestTimestamp é o carimbo de data/hora em requestHeader. Não é o mesmo que eventTimestamp, que pode ser qualquer horário.
- O merchantId no cabeçalho precisa corresponder ao valor do ID do comerciante no Console Business do Google Pay.
- A versão principal da solicitação é "2", que corresponde à "v2" no URL.
- O transactionId precisa corresponder ao transactionInfo.transactionId que você enviou em PaymentDataRequest.