Como tratar os cartões a expirar no Zuora
Evitar que cartões expirados façam falhar as renovações no Zuora: Payment Method Updater, updaters em tempo real, eventos a 15 e 30 dias, páginas alojadas.
Por Florian
Os cartões expirados são os pagamentos falhados mais previsíveis que existem. Conhece a data de expiração com meses de antecedência, e no entanto muitas renovações continuam a falhar em cartões que expiraram no mês passado. O Zuora dá-lhe duas ferramentas complementares contra isto: um updater automático que vai buscar os novos dados do cartão às redes de cartões, e eventos de expiração que lhe permitem pedir ao cliente antes de alguma coisa falhar.
Este guia explica as duas e dá-lhe depois uma configuração que pode aplicar. Baseia-se apenas na documentação do próprio Zuora: Payment Method Updater, a visão geral do Payment Method Updater, Set up Chase Payment Method Updater, Support for Real Time Account Updater (Adyen), Standard events for Zuora Payments e How do I allow customers to modify their stored payment methods? (todos consultados em novembro de 2026). Para o contexto geral sobre updaters e network tokens, veja network tokens e card account updaters.
Porque é que os cartões expirados continuam a falhar
Os bancos substituem cartões por muitas razões: expiração, perda, fraude, um novo design de cartão. O cliente recebe um cartão novo e atualiza os sítios de que se lembra; as subscrições que configurou há muito tempo não estão na lista. Quando a renovação corre com o cartão antigo, é recusada. Se ninguém intervier, um cliente que nunca quis sair perde-se.
Há duas formas de resolver isto:
- Obter os novos dados junto da rede, sem envolver o cliente. É o que fazem os serviços de account updater.
- Pedir ao cliente que atualize o cartão, de preferência antes de o antigo expirar.
Quer as duas, porque os updaters só cobrem os emissores participantes e alguns tipos de cartão.
Payment Method Updater (em lote)
O Payment Method Updater (PMU) do Zuora envia os dados dos cartões em lotes para os serviços de updater das redes de cartões e escreve os resultados de volta no Zuora. Segundo a documentação do PMU e a sua visão geral:
- Cobre Visa, Mastercard e American Express, através dos serviços Visa Account Updater, Mastercard Automatic Billing Updater e American Express Card Refresher.
- Corre antes de cada bill cycle day, para que os dados atualizados estejam no sítio quando o payment run cobra o cartão.
- Os resultados podem incluir um novo número de cartão (o Zuora guarda-o como novo meio de pagamento por defeito), uma nova data de expiração ou uma marca de conta encerrada. Os cartões marcados como encerrados deixam de ser usados para processar pagamentos.
- O serviço leva tipicamente 2 a 5 dias, porque o updater de cada rede corre segundo o seu próprio calendário.
Suporte dos gateways
O PMU configura-se por tipo de gateway. A documentação do Zuora indica suporte do PMU em gateways como Adyen, BlueSnap, Chase, Checkout.com, CyberSource, First Data, Merchant e-Solutions, Vantiv e Worldpay, e indica o Global Payments como não suportado. Alguns updaters (CyberSource, e o updater American Express do Zuora) funcionam sem um contrato separado de processamento de pagamentos com esse gateway; os outros exigem que processe também os pagamentos através dele. Um updater cobre todos os meios de pagamento de um tipo de gateway; a atualização de instâncias de gateway específicas não é suportada.
Escolher o momento do lote
Configura quantos dias antes do bill cycle day o serviço começa. A antecedência certa depende do gateway: para o Chase, o Zuora recomenda 10 dias, em Settings, Payments, Set Up Payment Method Updater (configuração do Chase). Começar tarde demais significa que a atualização chega depois de o payment run já ter sido recusado.
Quando os cartões não podem ser submetidos
O guia de resolução de problemas do Zuora indica que os dados de cartão inválidos aparecem com um estado Warning e um tipo de atualização NotApprovedForSubmitted, que pode exportar em Reporting, Data Sources. Esses cartões nunca serão atualizados automaticamente, por isso passam diretamente para o contacto com o cliente.
Updaters em tempo real
Alguns gateways atualizam os dados do cartão no momento do pagamento em vez de em lote. O Zuora documenta o suporte de account updater em tempo real para o Adyen (Adyen RTAU), limitado aos cartões Visa e Mastercard emitidos nos EUA e no Canadá, e uma página separada para um Stripe real-time account updater. Verifique as condições nessas páginas para a sua conta antes de contar com eles.
Eventos de expiração: pedir antes de falhar
Os standard events para pagamentos do Zuora incluem dois avisos de expiração ligados ao evento Payment Method Expiration:
| Evento | Quando dispara |
|---|---|
| 30 Day Warning | O meio de pagamento por defeito da conta expira em 30 dias |
| 15 Day Warning | O meio de pagamento por defeito da conta expira em 15 dias |
Detalhes da documentação do Zuora:
- A data de expiração de um cartão é o último dia do mês de expiração.
- Uma tarefa agendada avalia estes eventos diariamente (às 5h15 UTC para os tenants dos Cloud Data Centers UE e US 1, às 5h15 hora de Los Angeles para o US Cloud Data Center 2).
- Os avisos continuam a ser enviados para um meio de pagamento encerrado; o Zuora aconselha a não deixar um meio encerrado como predefinido da conta.
- Só dizem respeito ao meio de pagamento por defeito.
Cada aviso pode ser entregue por email ou como callout para o seu sistema. Como o PMU pode entretanto atualizar o cartão, faça com que o seu handler de email ou de callout volte a verificar a expiração na conta antes de enviar o que quer que seja ao cliente.
Dar ao cliente uma forma de atualizar
Quando o updater não pode ajudar, o cliente tem de introduzir um cartão novo. O guia do Zuora sobre a alteração dos meios de pagamento guardados descreve as opções:
- A hosted payment page (Payment Pages 2.0), carregada com o ID do meio de pagamento existente (
pmId) para que o cliente possa atualizar os dados do cartão. Isto mantém os dados do cartão fora dos seus servidores. - A API Update a payment method, que o Zuora desaconselha para dados de cartão, recomendando antes as Payment Pages 2.0.
- A interface do Zuora, para os agentes de suporte.
Ligue os seus emails de expiração diretamente a uma página que carrega o formulário de pagamento alojado para essa conta. Depois de o novo cartão ser guardado como predefinido, o próximo payment run usa-o.
Um plano de configuração
- Ative o PMU para cada tipo de gateway que usa, com uma antecedência adequada ao gateway (10 dias para o Chase, segundo o Zuora).
- Verifique as opções de updater em tempo real se processa através do Adyen ou do Stripe.
- Ative os avisos a 30 e 15 dias com um callout para o seu sistema.
- Volte a verificar antes de enviar. Se o PMU já atualizou o cartão, salte o email.
- Envie o email dos 30 dias com um link para a hosted payment page. Mantenha-o curto: que cartão, quando expira, um botão.
- Envie o lembrete dos 15 dias apenas se o cartão continuar inalterado.
- Exporte os cartões NotApprovedForSubmitted todos os meses e contacte diretamente esses clientes.
- Mantenha uma solução de recurso para pagamentos falhados. Alguns cartões vão falhar na mesma; veja como recuperar pagamentos falhados no Zuora.
Fazer isto com o NoChurn
O Payment Method Updater, os eventos de expiração e os payment runs do Zuora ficam no Zuora. O NoChurn lê do Zuora o tipo de meio de pagamento e a sua expiração e acrescenta emails escritos pela IA que revê antes de saírem, com um link para o cliente atualizar o meio de pagamento, além de emails de recuperação quando uma renovação falha mesmo assim. Cada cliente recebe também um score de churn de 0 a 100. Veja NoChurn + Zuora.