Por Que Isso é Importante?

Se você trabalha com assinaturas, planos parcelados ou carteiras digitais, sabe como é frustrante quando uma cobrança recorrente falha porque o cartão do usuário expirou. Antes dessa atualização, o Google Pay tratava toda transação como iniciada pelo cliente (CIT), sem dar ao comerciante uma forma clara de agendar cobranças futuras.

A novidade resolve isso com três novos objetos que permitem descrever exatamente quando e quanto cobrar. E mais importante: o tokenUpdateUrl avisa seu servidor quando o cartão do usuário muda, mantendo as cobranças ativas sem precisar que o cliente refaça tudo.

Quer ver como a inteligência artificial está transformando pagamentos empresariais? Dá uma olhada no nosso post sobre SAP + Microsoft no Sapphire 2026: O Plano para AI Autônoma nas Empresas.

Google Pay on smartphone showing recurring payment setup interface System Abstract Visual

Mão na Massa: Os Novos Objetos

1. recurringTransactionInfo

Use para assinaturas mensais, anuais ou qualquer plano com cobranças repetidas.

const paymentDataRequest = {
  apiVersion: 2,
  apiVersionMinor: 0,
  allowedPaymentMethods: [{
    type: 'CARD',
    parameters: {
      allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
      allowedCardNetworks: ['VISA', 'MASTERCARD', 'ELO']
    },
    tokenizationSpecification: {
      type: 'PAYMENT_GATEWAY',
      parameters: {
        'gateway': 'exemplo',
        'gatewayMerchantId': 'exemploMerchantId'
      }
    }
  }],
  recurringTransactionInfo: {
    label: 'Plano Premium Mensal',
    transactionId: 'SUB-2025-001',
    introductoryPeriodInfo: {
      label: 'Teste Grátis de 7 Dias',
      price: '0.00',
      priceStatus: 'FINAL',
      recurrencePeriod: {
        unit: 'DAY',
        count: 7
      }
    },
    recurrenceItems: [
      {
        label: 'Cobrança Mensal Padrão',
        price: '29.90',
        priceStatus: 'FINAL',
        recurrencePeriod: {
          unit: 'MONTH',
          count: 1
        }
      }
    ],
    managementUrl: 'https://meusite.com/assinaturas/gerenciar',
    tokenUpdateUrl: 'https://meusite.com/api/google-pay-token-updates'
  }
};

2. deferredTransactionInfo

Perfeito para reservas, depósitos ou qualquer pagamento único no futuro.

deferredTransactionInfo: {
  label: 'Depósito - Reserva de Verão',
  transactionId: 'DEF-2025-789',
  price: '150.00',
  priceStatus: 'ESTIMATED',
  deferredDate: '2025-07-01',
  managementUrl: 'https://meureserva.com/reservas/789',
  tokenUpdateUrl: 'https://meureserva.com/api/token-updates'
}

3. automaticReloadTransactionInfo

Ideal para carteiras digitais, jogos ou passes de transporte que recarregam automaticamente.

automaticReloadTransactionInfo: {
  label: 'Recarga Automática da Carteira',
  transactionId: 'REL-2025-456',
  reloadAmount: '25.00',
  triggerThreshold: '5.00',
  managementUrl: 'https://minhacarteira.com/config-recarga',
  tokenUpdateUrl: 'https://minhacarteira.com/api/token-updates'
}

O Diferencial: tokenUpdateUrl

Esse endpoint é um webhook que o Google chama quando o cartão do usuário é atualizado (ex.: vencimento, substituição). Seu servidor deve responder com 200 OK para confirmar o recebimento. Isso elimina a necessidade de o cliente reentrar os dados — redução de churn na faixa de 20-30%!

Para mais dicas sobre como ferramentas modernas estão turbinando integrações, veja nosso artigo sobre Agentic AI para Modernização: Como Azure e GitHub Copilot Estão Mudando o Jogo.

Cloud infrastructure diagram for Google Pay merchant initiated transaction processing Development Concept Image

Limitações e Cuidados

  • Disponibilidade do webhook: Seu endpoint tokenUpdateUrl precisa estar no ar 24/7. O Google tenta 3 vezes em 24 horas; se falhar, o token é marcado como expirado e o usuário precisa reautenticar.
  • PriceStatus: Use FINAL só quando o valor for garantido. ESTIMATED pode gerar reclamações se a cobrança final for diferente.
  • ManagementUrl obrigatório: O Google exige uma página onde o usuário cancele ou modifique a recorrência. Sem ela, sua integração pode ser rejeitada na revisão.
  • Disponibilidade regional: Esses recursos estão sendo liberados gradualmente. Confira a documentação oficial para países suportados.

Próximos Passos

  • Teste com cartões de teste do Google Pay no ambiente sandbox.
  • Configure logs e alertas no seu endpoint de webhook.
  • Fique de olho em novos status de preço que o Google pode adicionar.

Secure payment token lifecycle management with Google Pay API IT Technology Image

Conclusão

Essas melhorias transformam o Google Pay de um simples botão de compra em uma plataforma completa de pagamentos recorrentes. Para negócios de assinatura, o tokenUpdateUrl sozinho pode reduzir o churn involuntário em até 30%.

Comece integrando recurringTransactionInfo no seu fluxo de assinatura, depois adicione deferredTransactionInfo para pagamentos futuros únicos. A recarga automática é perfeita para carteiras de jogos ou passes de transporte.

Lembre-se: a melhor experiência de pagamento é aquela que o usuário nem percebe. Essas APIs te ajudam a chegar mais perto disso.

Fonte: Google Developers Blog - Novas melhorias para transações iniciadas pelo comerciante com a API Google Pay

Este conteúdo foi elaborado com o auxílio de ferramentas de IA, com base em fontes confiáveis, e revisado pela nossa equipe editorial antes da publicação. Não substitui o aconselhamento de um profissional especializado.