Transações iniciadas pelo comerciante (MITs)

Visão geral do suporte do MIT

As transações iniciadas pelo comerciante (MITs, na sigla em inglês) são processadas sem que o usuário esteja ativamente em uma sessão. Essa atualização da API Google Pay Online oferece mais 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 utilitários.
  • Pagamentos adiados:reservas de hotéis, pré-vendas 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 loadPaymentData atual. 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 testes, faturamento pré-pago e pós-pago.
Adiado DeferredTransactionInfo Usado para uma única cobrança em um horário futuro predeterminado.
Atualização automática AutomaticReloadTransactionInfo Usado para recarregar uma conta de valor armazenado quando o saldo fica abaixo de um limite mínimo.

Etapas de integração

  1. Documentação:as três novas definições de objeto estão localizadas na seção "Referência de objeto" da documentação e estão diretamente vinculadas na lista anterior.
  2. Implementação:use os objetos *TransactionInfo relevantes para seu sistema na solicitação de API.
    • Só é possível transmitir um objeto por solicitação à API. Determinar qual objeto usar e preencher os campos é 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 ao vivo assim que os parâmetros forem verificados.

Gerenciamento do ciclo de vida do token (TLM)

O gerenciamento do ciclo de vida do token garante a continuidade do pagamento ao fornecer notificações em tempo real quando os tokens de pagamento seguros são atualizados ou desativados. Para mais detalhes, consulte a documentação sobre 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 do FPAN:ocorrem quando o número da conta principal de financiamento é atualizado.

Requisitos de configuração do servidor

Os comerciantes diretos e os provedores de serviços de pagamento (PSPs) 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 recebendo 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.

Além disso, o payload criptografado vai retornar um campo opcional adicional, merchantTokenId, para MITs. Para detalhes específicos, consulte a Criptografia de dados de pagamento documentação (para comerciantes) ou Estrutura do payload documentação (para PSPs).