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:

  1. 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.

  2. 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.

  3. 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.

  4. Crie uma nova conta do Cloud Billing ou confirme se o faturamento está ativado no seu projeto.

  5. 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

  6. 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.

  7. 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.

    • 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.