Network tokens e card account updaters: o que resolvem e o que não resolvem
Como os network tokens e os card account updaters mantêm a funcionar os cartões guardados, como o Stripe os usa e que falhas não conseguem evitar.
Uma subscrição é uma promessa de cobrar o mesmo cartão durante meses ou anos. Os cartões não duram tanto. Expiram, são substituídos após um alerta de fraude, são reemitidos quando um banco muda o seu programa de cartões, ou são cancelados. Cada um destes eventos pode transformar um cliente saudável numa renovação falhada.
As redes de cartões têm dois mecanismos para atenuar isto: os card account updaters e os network tokens. O Stripe usa os dois por si, quase sempre sem qualquer configuração. Vale a pena percebê-los, porque explicam porque é que alguns cartões continuam a funcionar quando “deveriam” ter falhado, e porque é que outros falham de qualquer forma. Este guia trata dos dois, com base na documentação do Stripe e das próprias redes (consultada em novembro de 2026).
O problema que resolvem
Quando guarda um cartão para uma subscrição, o Stripe guarda o número do cartão (o PAN) e a data de validade, de forma segura, em seu nome. Se o banco do cliente emitir um novo cartão com um novo número ou uma nova data de validade, os dados guardados ficam desatualizados. A cobrança seguinte falha, normalmente com expired_card ou outra recusa. Veja os códigos de recusa do Stripe explicados.
Os dois mecanismos procuram fazer-lhe chegar os novos dados antes que isso aconteça.
Card account updaters
Como funcionam
Um card account updater é um serviço gerido por uma rede de cartões. Os emissores que participam comunicam as alterações dos seus cartões (novo número, nova data de validade, conta encerrada), e os comerciantes ou os seus prestadores de pagamento podem receber essas alterações para os cartões que guardam.
Os principais:
- Visa Account Updater (VAU). A documentação para programadores da Visa descreve-o como uma forma de emissores, adquirentes e comerciantes qualificados trocarem informação de conta atualizada para pagamentos recorrentes e com cartão guardado, cobrindo números de cartão, datas de validade, contas encerradas e avisos “contact cardholder”.
- Mastercard Automatic Billing Updater (ABU). A documentação para programadores da Mastercard descreve um repositório de eventos do ciclo de vida das contas: os emissores informam o ABU quando uma conta é criada, atualizada ou encerrada. Para uma conta encerrada, a orientação da Mastercard é que o comerciante use outro método de pagamento nas transações futuras.
O que o Stripe faz
Não se integra com estes serviços diretamente. A visão geral dos cartões do Stripe explica que o Stripe tenta atualizar automaticamente os dados dos cartões guardados quando um cliente recebe um novo cartão, usando os programas de atualização das redes. Pontos-chave da documentação do Stripe:
- A cobertura depende do emissor e varia por país; é mais forte nos EUA.
- Não pode saber antecipadamente que cartões serão atualizados.
- Pode ver as atualizações à medida que acontecem. O Stripe envia o webhook
payment_method.automatically_updatedcom a nova data de validade e os últimos quatro dígitos. Se o número mudou, a impressão digital (fingerprint) do cartão também muda.
O Stripe anunciou também uma cobertura alargada de network tokens e card account updater, incluindo atualizações em tempo real em alguns casos. Consulte o anúncio para saber o âmbito atual nos seus mercados.
Network tokens
Como funcionam
Um network token é um substituto do número do cartão, emitido pela rede de cartões (por exemplo através do Visa Token Service) e associado a um comerciante ou prestador de pagamento específico. Em vez de cobrar o número de cartão em bruto, o prestador de pagamento cobra o token.
A propriedade útil para as subscrições: o token está ligado à conta do titular na rede, não a um cartão físico. Quando o emissor substitui o cartão, a rede pode atualizar o que está por trás do token. A documentação do token service da Visa descreve como os emissores gerem o ciclo de vida de um token (ativar, suspender, retomar, eliminar) e como a Visa pode ir buscar ao VAU os dados atualizados do cartão para manter os tokens em dia quando o número ou a data de validade do cartão subjacente mudam.
O que o Stripe faz
O guia sobre network tokens do Stripe explica que o Stripe tokeniza os cartões guardados junto das principais redes, quando disponível, e decide em cada pagamento se usa o network token ou o número do cartão. Se um pagamento no network token falhar, o Stripe pode tentá-lo de novo com o número do cartão. O guia do Stripe refere também duas contrapartidas: usar um network token exige muitas vezes obter um criptograma de uso único junto da rede, o que pode acrescentar latência, e algumas redes cobram taxas relacionadas com o uso de tokens.
Para a maioria dos negócios de subscrição, nada disto exige código. Faz parte da forma como o Stripe processa os cartões guardados.
Updaters vs tokens
| Card account updater | Network token | |
|---|---|---|
| O que é | Um fluxo de alterações de cartões vindo dos emissores | Um número de cartão substituto emitido pela rede |
| Como chegam os novos dados | O Stripe recebe a atualização e altera o cartão guardado | A rede atualiza aquilo para que o token aponta |
| Visível para si | Sim, webhook payment_method.automatically_updated |
Quase nunca; o cartão continua a funcionar |
| Depende de | Participação do emissor, país | Suporte da rede e do emissor |
| Cobre cartões expirados e substituídos | Sim, quando o emissor os comunica | Sim, quando suportado |
| Cobre contas encerradas | Pode comunicar o encerramento, para saber que tem de pedir um novo cartão | O token deixa de funcionar |
Na prática sobrepõem-se, e o Stripe combina-os. Não tem de escolher entre eles.
O que não resolvem
Esta é a parte importante. Os updaters e os tokens resolvem um problema, os dados de cartão desatualizados, e apenas quando os emissores participam. Não fazem nada pelo resto:
| Falha | Resolvida por updaters ou tokens? | O que a resolve |
|---|---|---|
| Cartão expirado, o emissor enviou a nova validade | Sim | Nada mais é preciso |
| Cartão substituído, o emissor enviou o novo número | Sim | Nada mais é preciso |
| Cartão expirado, o emissor não participa | Não | Email antes da expiração, página de atualização do cartão |
| Conta encerrada | Não (no máximo, fica a saber) | Pedir um novo método de pagamento |
insufficient_funds |
Não | Nova tentativa num momento melhor; email |
| Recusa genérica, bloqueio do banco | Não | Nova tentativa; email; o cliente liga ao banco |
authentication_required |
Não | O cliente confirma o pagamento |
| O cliente mudou completamente de banco | Não | Pedir um novo cartão |
| O cliente removeu o cartão de propósito | Não | Falar com o cliente |
Esta última linha merece atenção. Quando um cliente remove o cartão guardado antes de uma renovação, é muitas vezes sinal de que pretende sair ou contestar a próxima cobrança. É um sinal de churn, não um problema de pagamento, e deve ser tratado como tal.
O que fazer do seu lado
Mesmo com boa cobertura, precisa de um processo para os cartões que não são atualizados. A abordagem completa está em cartões a expirar; em resumo:
1. Ouça as atualizações
Subscreva payment_method.automatically_updated. Registe cada atualização (validade antiga, nova validade, se o número mudou). Diz-lhe que parte da sua base as redes estão a cobrir e permite-lhe cancelar qualquer email “o seu cartão vai expirar” que estivesse prestes a enviar.
2. Encontre os cartões que não serão atualizados a tempo
Antes de cada renovação, verifique se o cartão guardado expira antes da data de renovação. Se expirar, e não tiver chegado nenhuma atualização uma ou duas semanas antes da renovação, envie um email ao cliente.
3. Esteja atento a encerramentos e remoções
Um aviso de encerramento ou um cartão removido significa que a próxima cobrança vai falhar. Peça logo um novo método de pagamento, em vez de esperar que a renovação falhe.
4. Mantenha os emails de recuperação para o resto
A maioria dos pagamentos falhados não tem a ver com dados de cartão desatualizados. As novas tentativas e emails de recuperação claros continuam a fazer a maior parte do trabalho de recuperação. Veja como recuperar pagamentos falhados no Stripe.
5. Prefira métodos de pagamento que duram
Alguns métodos de pagamento adequam-se melhor à faturação recorrente do que outros. Os cartões pré-pagos e virtuais, por exemplo, trazem os seus próprios riscos de renovação, que os updaters e os tokens não resolvem. Veja cartões pré-pagos e virtuais.
Medir a cobertura
Acompanhe isto todos os meses:
- Atualizações automáticas recebidas: número de eventos
payment_method.automatically_updated, separados entre “só validade” e “novo número”. - Cartões a expirar não atualizados: cartões com validade anterior à próxima renovação e sem atualização até uma data definida.
- Falhas
expired_card: quantas renovações ainda falham com um cartão expirado. Se este número for alto, os seus emails antes da expiração precisam de trabalho. - Distribuição por país e marca do cartão: a cobertura varia, por isso uma taxa de falha alta num país pode apontar para a participação dos emissores e não para o seu processo.
Checklist
-
payment_method.automatically_updatedé registado. - Os emails antes da expiração não são enviados para cartões já atualizados.
- Os cartões que expiram antes da próxima renovação são assinalados.
- Os cartões removidos e as contas encerradas desencadeiam um pedido imediato de novo método de pagamento.
- As falhas são reportadas por código de recusa, para ver o que os updaters não cobrem.
- Os emails de recuperação tratam de todo o resto.
Como o NoChurn ajuda
O NoChurn funciona ao lado dos updaters e dos tokens do Stripe e cobre o que eles deixam. Assinala os clientes que removem o cartão antes da renovação, subindo o seu score de churn para que os possa contactar antes de o pagamento falhar. Quando uma renovação falha, lê o código de recusa, volta a tentar as recusas temporárias em melhores momentos e envia emails de recuperação escritos por IA, revistos antes do envio, com uma página alojada de atualização do cartão. Os dados do cartão ficam no Stripe; o NoChurn só vê dados como a marca, os últimos quatro dígitos, a validade e o tipo de financiamento.
Liga-se ao Stripe num clique, e o preço depende apenas do MRR. Veja pagamentos falhados, o score de churn e preços.