Braintree Account Updater e cartões a expirar

Quando o cartão de um cliente expira ou é substituído, cada subscrição no cartão antigo é um pagamento falhado à espera de acontecer. O Braintree oferece dois serviços que vão buscar os novos dados do cartão às redes sem pedir nada ao cliente: o Account Updater e os network tokens. Nenhum dos dois cobre todos os cartões, por isso continua a precisar de uma forma de contactar os clientes que escapam.

Este guia explica como funciona cada serviço, os detalhes que contam para subscrições e um plano para o resto. Baseia-se na documentação do próprio Braintree: Account Updater, o webhook do Account Updater, o relatório Expiring Cards, Network tokens overview, How network tokens work, Updating vault records e Recurring billing advanced settings (todos consultados em novembro de 2026). Para a visão geral entre fornecedores, veja network tokens e card account updaters e cartões a expirar.

Account Updater

O que faz

Segundo o guia do Account Updater do Braintree, o Account Updater pede automaticamente atualizações para métodos de pagamento guardados no vault quando o cartão de um cliente expira ou é substituído, para ajudar a evitar transações falhadas. Funciona através dos programas de atualização das redes de cartões, por isso uma atualização só chega se o banco emissor participar.

Quem o pode usar

O Account Updater não está ativo por predefinição. O Braintree diz que a maioria dos comerciantes Braintree Direct sediados nos EUA, ou que transacionam sobretudo com clientes dos EUA, o pode ativar, e pede aos restantes que o contactem. As taxas estão definidas no seu contrato: o disbursement fee report do Braintree inclui o Account Updater entre as taxas de produto faturadas como taxas por evento. Verifique o preço no seu contrato.

O que não cobre

Cartões pré-pagos não são suportados.
Cartões usados através do Apple Pay ou do Google Pay não são suportados.
Marcas de cartão: o guia para developers do Braintree indica Visa, Mastercard e Discover, enquanto a sua página de marketing menciona também a American Express. As duas fontes discordam quanto à Amex; confirme com o Braintree para a sua conta.

Quando os cartões são verificados

Depois de um lote inicial, o Braintree envia pedidos de atualização de forma contínua. O guia descreve vários gatilhos, incluindo:

um pagamento recorrente a vencer nas duas semanas seguintes;
uma recusa no cartão, com uma exceção documentada que conta para subscrições: um cartão numa subscrição mensal que foi cobrado com sucesso 30 dias antes não é adicionado a um lote na primeira vez que é recusado.

Essa exceção significa que a primeira renovação mensal falhada num cartão substituído pode não desencadear sozinha uma atualização. As suas novas tentativas e os emails aos clientes têm de cobrir esse caso.

Next Day Card Refresh

O Braintree descreve também o Next Day Card Refresh, que tenta atualizar cartões guardados depois de uma autorização ser recusada com determinados códigos de recusa. Só ajuda se algo voltar a tentar o pagamento depois, seja as novas tentativas da faturação recorrente do Braintree, seja a sua própria lógica. Se as suas definições de novas tentativas estiverem desativadas, o cartão atualizado fica sem uso até ao ciclo de faturação seguinte. Verifique-as em Account Settings, Recurring Billing, Options (definições avançadas).

Ver o que mudou

Pode rever as atualizações no Control Panel, num relatório gerado ou através do webhook Account Updater daily report. Segundo a referência do webhook:

só está disponível para comerciantes que usam o Account Updater;
é disparado uma vez por dia com os métodos de pagamento atualizados nas últimas 24 horas, e não é disparado se não houver nenhum;
o payload contém uma data de relatório e um URL do relatório, e o link expira ao fim de uma semana.

Descarregue e guarde o relatório assim que chega. Se um cartão foi atualizado, já não precisa de enviar email a esse cliente sobre o assunto.

Network tokens

Os network tokens são um serviço separado do Braintree. Segundo a visão geral dos network tokens e como funcionam:

A rede de cartões passa as atualizações do emissor (reemissão, roubo, perda e alterações como uma expiração próxima) ao Braintree, que atualiza os dados do cartão no seu vault.
Não é preciso alterar a integração para começar a usá-los.
Estão disponíveis para comerciantes nos Estados Unidos e em regiões selecionadas da América do Norte, América do Sul e Europa que processam full stack com o Braintree.
Um token pode nem sempre ser usado numa dada transação.

O Braintree documenta também que as cobranças recorrentes iniciadas pelo comerciante levam parâmetros adicionais (como a origem da transação e o ID da transação de rede anterior) quando executa pagamentos recorrentes fora da faturação recorrente do próprio Braintree. Se usa as subscrições do Braintree, confirme com o Braintree como os tokens se aplicam à sua configuração.

	Account Updater	Network tokens
Como atualiza	Pedidos aos programas de atualização das redes, em lotes e por gatilhos	Atualizações do ciclo de vida da rede para o token
Configuração	Tem de ser ativado; elegibilidade sobretudo nos EUA	Sem alteração de integração; disponibilidade regional
Lacunas	Pré-pagos, Apple Pay, Google Pay; emissores que não participam	O token nem sempre é usado

O relatório Expiring Cards

Para os cartões que nenhum dos serviços apanha, o Control Panel do Braintree tem um relatório Expiring Cards: vá a Reports, encontre a secção Vault e execute Expiring Cards. Pode filtrar por um intervalo de datas personalizado ou ver todos os cartões expirados. Execute-o todos os meses para o mês seguinte.

A armadilha das subscrições: cartões novos não mudam as subscrições

A documentação do vault do Braintree chama a atenção para o facto de que adicionar um novo método de pagamento ao vault de um cliente não atualiza as suas subscrições existentes. Se um cliente adicionar um novo cartão através da sua app, tem também de atualizar cada subscrição para usar o novo método de pagamento e depois repetir qualquer cobrança em atraso com Subscription: Retry Charge. Esquecer este passo é uma razão comum para um cliente ter “atualizado o cartão” e mesmo assim se ter perdido.

Um plano para cartões a expirar no Braintree

Ative o Account Updater se for elegível, e os network tokens onde estiverem disponíveis.
Ative as novas tentativas automáticas na faturação recorrente, para que o Next Day Card Refresh tenha algo sobre que agir.
Guarde o relatório diário do Account Updater e marque os cartões atualizados no seu sistema.
Execute o relatório Expiring Cards todos os meses para os cartões que expiram no mês seguinte.
Envie email aos clientes cujos cartões não foram atualizados, 30 dias e de novo cerca de 7 dias antes da expiração, com um único link para uma página de atualização do cartão.
Na página de atualização, guarde o novo cartão, mude todas as subscrições para ele e repita qualquer cobrança em atraso.
Cubra a primeira renovação mensal falhada. Como o cartão de uma subscrição mensal não entra num lote na primeira recusa, envie de imediato um email de recuperação em vez de esperar pelo updater.
Exclua os cartões não suportados (pré-pagos, Apple Pay, Google Pay) de qualquer pressuposto de que o updater vai tratar deles.

Fazer isto com o NoChurn

O Account Updater, os network tokens e a própria cobrança ficam com o Braintree. O NoChurn lê do Braintree o tipo de método de pagamento, a marca, os últimos quatro dígitos e a validade, e acrescenta emails escritos pela IA que revê antes de serem enviados, com uma página alojada onde o cliente atualiza o método de pagamento. Quando uma renovação falha mesmo assim, seguem-se emails de recuperação a par das novas tentativas das subscrições do Braintree. Veja NoChurn + Braintree.