Como tratar os cartões a expirar no Maxio

Um cartão a expirar é o pagamento falhado mais previsível que existe: sabe o mês em que vai deixar de funcionar antes de acontecer. O Maxio Advanced Billing (antigo Chargify) dá-lhe três ferramentas para isso: emails automáticos de expiração do cartão, um webhook expiring_card e suporte para o account updater em alguns gateways. Este guia explica o que faz cada uma, onde deixam lacunas e como combiná-las para que as renovações não falhem por um motivo que podia ver chegar.

Limita-se à documentação do próprio Maxio: configurar as definições de email, modelos de email, eventos de webhooks, exemplos de payloads, comparar as funcionalidades dos gateways, gerir métodos de pagamento, atualizar as informações de pagamento de um cliente e o glossário do Advanced Billing (todos consultados em novembro de 2026). Quando as páginas do Maxio não concordam, dizemo-lo. Para o que acontece quando uma renovação já falhou, veja como reduzir o churn involuntário no Maxio.

Passo 1: deixar o account updater fazer o que pode

As redes de cartões têm serviços de account updater: quando um banco reemite um cartão, o novo número ou a nova data de validade podem chegar ao comerciante sem que o cliente faça nada. No Maxio, o suporte depende do seu gateway:

Gateway	Account updater no Advanced Billing
Stripe, BlueSnap, Cybersource, Forte (Beta), Maxio Payments	Totalmente suportado: o Maxio recebe as atualizações e mantém os dados de cartão guardados em dia
Outros gateways	O updater do gateway em geral continua a funcionar através do seu token, por isso as cobranças podem resultar, mas os novos dados do cartão podem não aparecer no Advanced Billing

Alguns gateways exigem configuração. Para o BlueSnap, o guia de configuração do Maxio pede-lhe que configure os webhooks do BlueSnap e marque “Send Account Updater”. Para o Forte, o updater tem de ser ativado primeiro na conta Forte. No Stripe, a documentação do Maxio associa o updater automático à integração Stripe Connect.

Dois limites da documentação do Maxio:

• Nem todos os emissores participam. Um updater só funciona quando o emissor do cartão participa, por isso alguns cartões vão expirar sem atualização.
• Um updater pode desativar um perfil. Quando um updater não encontra uma conta, pode apagar o registo, deixando o perfil de pagamento do subscritor desativado. A página de métodos de pagamento do Maxio diz que, no momento em que foi escrita, isto só tinha acontecido a comerciantes Authorize.Net que usavam o updater.

O segundo ponto importa para o primeiro: se o seu gateway atualiza o cartão em silêncio e o Maxio não o mostra, o Maxio pode continuar a achar que o cartão está prestes a expirar e enviar um email ao cliente sobre isso. Saiba em que caso está antes de escrever o email.

Passo 2: emails de expiração do cartão

O Maxio pode enviar Card Expiration Emails aos clientes cujo cartão registado está prestes a expirar (modelos de email). O modelo pode incluir o número de dias até à expiração e um link de atualização, {{update_url}}, que é o URL de self-service da subscrição, para que o cliente introduza ele próprio o novo cartão e você nunca lide com dados de cartão.

Quando são enviados: duas versões na documentação do Maxio

As páginas do Maxio dão dois calendários:

• A atual página de definições de email diz que os emails saem três vezes durante o mês em que o cartão expira: no dia 1, no dia 15 e uma semana antes do fim do mês (por isso a terceira data muda com a duração do mês).
• O glossário e a página dos modelos de email referem os dias 1, 15 e 23, e o glossário fala do mês anterior à expiração do cartão.

A página de definições de email é a mais precisa e parece ser a mais recente, mas verifique um envio real no seu site antes de construir algo que dependa das datas exatas.

Torne o email útil

O modelo predefinido é um ponto de partida. Um bom email de cartão a expirar:

1. Diz qual é o cartão (marca e últimos quatro dígitos) e qual é a subscrição.
2. Dá a data em que a próxima renovação será cobrada, se for depois da expiração.
3. Tem um botão para o link de atualização, que funciona no telemóvel, sem palavra-passe para lembrar.
4. Vem da sua marca e de um endereço de resposta real.

Passo 3: o webhook expiring_card

O Maxio envia também um webhook expiring_card. Segundo a sua página de eventos de webhooks, é periódico: enviado no dia 1, no dia 15 e 7 dias antes do fim do mês, e identifica todos os cartões que expiram no mês em curso. O payload traz o objeto subscription, com o cliente, o produto e os dados do cartão.

Note o que isso significa: o webhook chega no mês da expiração, não semanas antes. Para um plano mensal faturado no início do mês, não há problema. Para um cliente cuja renovação é no dia 2 e cujo cartão expira no fim desse mês, também não. Mas para um plano anual que renova na próxima primavera, um alerta “expira este mês” hoje não é o problema; o problema é o cartão que estará registado na renovação. Use o webhook como gatilho, e decida o que fazer com a sua própria lógica:

• Renovação antes da expiração: nenhuma ação necessária agora; a próxima renovação vai resultar.
• Renovação depois da expiração, plano mensal: peça um novo cartão já.
• Plano anual: compare você mesmo, com antecedência, a data de validade do cartão com a data de renovação, em vez de esperar pelo webhook.

Passo 4: outras formas de obter um novo cartão

Quando o email não resulta, o Maxio oferece opções manuais e em massa (atualizar as informações de pagamento de um cliente):

• A partir da subscrição. No separador Payment Details, “Email Customer to Request Payment Update” envia ao cliente um link para a sua página de self-service. O Maxio recomenda isto em vez de introduzir os novos dados do cartão pelo cliente.
• Em massa. Um email em massa pré-escrito “Request Payment Method Update” envia um link de atualização seguro a um grupo de subscritores.
• No Billing Portal. Os clientes acrescentam um cartão em Payment, ou usam Update Payment Method numa subscrição específica.
• Maxio Core. Se usa o Maxio Core em vez do Advanced Billing, a documentação descreve como copiar um link da página do perfil de faturação e-Bill do cliente e enviá-lo.

Acrescente também uma mensagem dentro do seu próprio produto: um banner para o titular da conta quando o cartão expira este mês chega a quem ignora os emails.

Uma checklist

• Sabe se o account updater do seu gateway é totalmente suportado no Advanced Billing.
• As definições do updater do lado do gateway estão ativadas onde é necessário.
• Os Card Expiration Emails estão ativos, com a sua marca e um link de atualização que funciona.
• Verificou num envio real que calendário o Maxio usa no seu site.
• expiring_card é tratado, com lógica para planos mensais vs anuais.
• Nos planos anuais, a expiração é comparada com a data de renovação com bastante antecedência.
• Um banner na app aparece quando o cartão registado está prestes a expirar.
• O dunning está configurado para os cartões que não conseguiu apanhar a tempo.

Fazer isto com a NoChurn

A NoChurn lê as subscrições do Maxio e o tipo e a data de validade de cada perfil de pagamento, e usa-os no churn score de 0 a 100 do cliente. Quando uma renovação falha, a NoChurn envia emails de recuperação escritos por IA e revistos por si, a par do seu dunning no Maxio, com um link para atualizar o perfil de pagamento. Os dados do cartão, a cobrança e o account updater ficam com o Maxio e o seu gateway. A NoChurn é gratuita abaixo de 300 $ de MRR, com todas as funcionalidades em todos os planos (o seu próprio domínio de email a partir de 9 $). Veja NoChurn + Maxio.