Transações iniciadas pelo comerciante (MITs)

Visão geral do suporte a MIT

As transações iniciadas pelo comerciante (MITs, na sigla em inglês) são processadas sem que o usuário esteja ativamente na sessão. Essa atualização da API Google Pay Online oferece maior visibilidade para esses tipos de transação, uma experiência do usuário aprimorada com uma UX de detalhes de faturamento dedicada e melhor continuidade de pagamento.

Principais casos de uso

  • Pagamentos recorrentes:serviços de streaming digital, assinaturas ou serviços públicos.
  • Pagamentos adiados:reservas de hotel, pré-encomendas ou taxas de não comparecimento.
  • Recargas automáticas:recargas de valor armazenado para transporte público ou vales-presente.

Implementação da API MIT

A API MIT é uma extensão da API existente LoadPaymentData . Os integradores precisam incluir exatamente um objeto *TransactionInfo para especificar a intenção de faturamento. O Google oferece três opções, dependendo do tipo de transação iniciada pelo comerciante:

Tipo de transação Nome do objeto Descrição
Recorrente RecurringTransactionInfo Usado para cobranças de frequência fixa. Aceita faturamento de teste, pré-pago e pós-pago.
Adiada DeferredTransactionInfo Usado para uma única cobrança em um horário futuro predeterminado.
Recarga automática AutomaticReloadTransactionInfo Usado para recarregar uma conta de valor armazenado quando um saldo fica abaixo de um limite mínimo.

Etapas de integração

  1. Documentação:acesse o DevSite durante o programa de acesso antecipado. As três novas definições de objeto estão localizadas na seção "Referência de objeto", e estão vinculadas diretamente na lista anterior.
  2. Implementação:use os objetos *TransactionInfo relevantes para seu sistema na solicitação de API.
    • Somente um objeto pode ser transmitido por solicitação à API. A determinação de qual objeto usar e o preenchimento dos campos é de responsabilidade do comerciante.
  3. Teste:use o ambiente de TESTE para validar se os detalhes de faturamento são renderizados corretamente na folha de pagamento.
  4. Lançamento:entre no ar quando os parâmetros forem verificados.

Gerenciamento do ciclo de vida do token (TLM, na sigla em inglês)

O gerenciamento do ciclo de vida do token garante a continuidade do pagamento, fornecendo notificações em tempo real quando os tokens de pagamento seguros são atualizados ou desativados. Para mais detalhes, consulte a documentação sobre o gerenciamento do ciclo de vida do token .

Principais eventos de token

  • Desativação/exclusão:notifica quando um token não pode mais ser usado.
  • Atualizações de sufixo FPAN: ocorrem quando o número da conta principal de financiamento subjacente é atualizado.

Requisitos de configuração do servidor

Comerciantes diretos e provedores de serviços de pagamento (PSPs, na sigla em inglês) precisam estabelecer um sistema para receber, descriptografar e processar essas mensagens.

Requisito Descrição
Endpoint Endpoint HTTPS seguro para receber chamadas POST.
Authentication Precisa processar a validação de assinatura e a descriptografia de mensagens.
Resposta Retorne SUCCESS para continuar as notificações ou TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE para interrompê-las.
Notificação do comerciante Os PSPs precisam comunicar o status do token aos comerciantes.

Notas de implementação

O endpoint tokenUpdateUrl precisa ser transmitido com a transação para receber atualizações do token. Para PSPs, determinar como os comerciantes vão receber e preencher esse URL no objeto *TransactionInfo relevante é responsabilidade do PSP.

O payload criptografado também vai retornar um campo opcional extra, merchantTokenId, para MITs. Para detalhes específicos, consulte a documentação sobre criptografia de dados de pagamento (para comerciantes) ou a documentação sobre a estrutura do payload (para PSPs).