Como recuperar pagamentos falhados no Stripe: guia completo
Guia prático para recuperar pagamentos falhados no Stripe: recusas temporárias e definitivas, novas tentativas, emails, atualização do cartão e medição.
Um pagamento de subscrição falhado ainda não é um cliente perdido. Na maioria das vezes, o cliente continua a querer o produto; o cartão foi recusado por uma razão que ele talvez nem conheça. O que acontece nas duas semanas seguintes decide se essa fatura é paga ou se a subscrição termina discretamente.
Este guia percorre todo o processo de recuperação no Stripe: ler os códigos de recusa, configurar as novas tentativas, escrever os emails, dar aos clientes uma forma fácil de atualizar o cartão e medir o que recupera de facto. Tudo o que é específico do Stripe tem link para a documentação do Stripe, para que possa verificar as definições atuais na sua própria conta.
Porque é que os pagamentos falhados contam mais do que parece
Os pagamentos falhados provocam o chamado churn involuntário: o cliente não escolheu sair, o pagamento simplesmente não passou. Os benchmarks de churn do Recurly (consultados em novembro de 2026) situam o churn involuntário mensal médio, em todos os setores, em 1,25%, contra 3,60% de churn total. É cerca de um terço de todo o churn, e é a parte que pode corrigir sem mudar o produto nem os preços.
Se quiser as definições e as contas, veja o que é o churn involuntário e como o medir.
Passo 1: ler o código de recusa
Cada cobrança por cartão falhada no Stripe traz um código de recusa no charge ou no PaymentIntent. O código diz-lhe que tipo de problema tem, e a resposta certa depende dele. O Stripe publica a lista completa, com um próximo passo sugerido para cada um, na sua referência de códigos de recusa.
Recusas temporárias: voltar a tentar pode funcionar
Uma recusa temporária (soft decline) é passageira. O cartão é válido, mas o emissor disse que não desta vez. Causas típicas:
insufficient_funds: não há dinheiro ou crédito suficiente disponível neste momento.generic_declineoudo_not_honor: o emissor recusou sem dar razão.try_again_laterouprocessing_error: um problema temporário do lado do emissor ou da rede.card_velocity_exceeded: o cliente atingiu um limite de gastos ou de transações.
São as recusas em que o momento da nova tentativa conta. Um cartão que falha no dia 28 do mês por fundos insuficientes pode passar no dia 1.
Recusas definitivas: só voltar a tentar não vai resultar
Uma recusa definitiva (hard decline) quer dizer que o cartão não pode voltar a ser cobrado tal como está. O cliente tem de lhe dar um novo método de pagamento. A documentação das Smart Retries do Stripe lista os códigos de recusa definitiva que não volta a tentar por si: incorrect_number, lost_card, pickup_card, stolen_card, revocation_of_authorization, revocation_of_all_authorizations, authentication_required, highest_risk_level e transaction_not_allowed. Nestes casos, as novas tentativas agendadas continuam a aparecer na fatura, mas um pagamento só é feito depois de associado um novo método de pagamento.
Os cartões expirados (expired_card) também exigem uma ação do cliente, a menos que a rede de cartões envie ao Stripe os novos dados. Tratamos esse caso no guia sobre cartões a expirar.
Uma tabela de triagem rápida
| Tipo de recusa | Exemplos de códigos | O que fazer |
|---|---|---|
| Temporária, fundos | insufficient_funds |
Voltar a tentar num momento melhor; enviar email ao cliente |
| Temporária, pouco clara | generic_decline, do_not_honor |
Voltar a tentar algumas vezes; enviar email; sugerir que contacte o banco |
| Exige autenticação | authentication_required |
Enviar um link para o cliente confirmar o pagamento |
| Cartão inutilizável | lost_card, stolen_card, incorrect_number |
Não voltar a tentar; pedir logo um novo cartão |
| Cartão expirado | expired_card |
Pedir um novo cartão; verificar se o cartão foi atualizado automaticamente |
Uma ressalva da própria documentação do Stripe: em códigos como fraudulent ou lost_card, não diga ao cliente o motivo específico. Mostre antes uma mensagem genérica do tipo “o seu pagamento foi recusado”.
Passo 2: configurar as novas tentativas
O Stripe Billing pode voltar a tentar automaticamente os pagamentos de faturas falhados. Configura-o no Dashboard, nas definições de recuperação de receita. Tem duas opções, segundo a documentação do Stripe:
- Smart Retries: o modelo do Stripe escolhe os momentos das novas tentativas usando sinais dinâmicos e dependentes do tempo. O valor por omissão recomendado pelo Stripe é de 8 tentativas em 2 semanas, e pode escolher uma janela mais longa ou mais curta.
- Um calendário personalizado: até três novas tentativas, cada uma um número definido de dias após a tentativa anterior.
Escolhe também o que acontece à subscrição quando a última nova tentativa falha: cancelá-la, marcá-la como unpaid ou deixá-la past due.
Para a maioria dos negócios, as Smart Retries são o ponto de partida certo. Os casos em que um calendário personalizado faz sentido (bases de clientes muito dependentes do dia do salário, faturas B2B, janelas muito curtas) são tratados em como funcionam as Smart Retries do Stripe.
Checklist das novas tentativas
- As novas tentativas estão ativas para as faturas de subscrição com cobrança automática.
- A janela de novas tentativas corresponde ao seu ciclo de faturação (uma janela de 2 meses num plano mensal quer dizer que a fatura seguinte chega antes de a última estar regularizada).
- A ação no fim das novas tentativas é uma escolha deliberada, não o valor por omissão para que nunca olhou.
- As recusas definitivas desencadeiam um email imediato, sem esperar pela nova tentativa seguinte.
Passo 3: enviar um email ao cliente
As novas tentativas recuperam o que o banco deixa passar. Os emails recuperam o resto: os cartões expirados, os cartões substituídos, os clientes que têm de transferir dinheiro ou ligar ao banco.
O Stripe pode enviar emails básicos por si. Nas definições de emails aos clientes, pode ativar emails quando os pagamentos por cartão falham, emails sobre cartões a expirar e lembretes de renovações próximas. São uma base razoável. Os seus limites são o texto genérico e o facto de não estarem ajustados ao seu calendário de novas tentativas nem ao motivo da recusa.
Uma boa sequência de emails de recuperação costuma ser assim:
| Quando | Objetivo | Tom |
|---|---|---|
| Dia 0 (primeira falha) | Informar o cliente, dar o link de atualização | Neutro, curto, sem culpa |
| Dia 3 | Lembrar, explicar o que acontece a seguir | Prestável |
| Dia 7 | Deixar claro o prazo | Direto |
| Dia 14 (última nova tentativa) | Último aviso antes de o acesso mudar | Claro e respeitoso |
Os bons emails de recuperação têm alguns traços em comum:
- Uma ação. Um único botão para a página de atualização do cartão. Sem links extra.
- Remetente e assunto simples. De uma pessoa ou do nome do seu produto, com um assunto que diz o que aconteceu (“O seu pagamento da Acme não passou”).
- Os factos. Montante, plano, marca e últimos quatro dígitos do cartão, e a data em que o serviço muda.
- Sem culpa. Os cartões falham por razões que o cliente não controla.
- Um endereço de resposta real. Alguns clientes vão responder com uma pergunta. Alguém deve lê-la.
Escrevemos modelos prontos a usar para cada passo em modelos de emails de recuperação para os dias 0, 3, 7 e 14.
Passo 4: tornar a atualização do cartão sem esforço
O email consegue o clique. A página de atualização do cartão consegue o pagamento. Cada passo a mais nessa página faz perder pessoas.
No Stripe tem três opções habituais:
- A página de fatura alojada. Cada fatura tem uma página alojada pelo Stripe onde o cliente pode pagar com um novo cartão.
- O customer portal. Uma página alojada pelo Stripe onde os clientes gerem métodos de pagamento, faturas e subscrições.
- A sua própria página, construída com Stripe Elements ou com o Checkout em modo setup.
Seja qual for a que usar, verifique:
- O link inicia a sessão do cliente ou funciona sem palavra-passe. Pedir a um cliente que se lembre de uma palavra-passe para resolver um pagamento falhado é um ponto de abandono frequente.
- A página funciona bem num telemóvel. Muitos emails de recuperação são abertos no telemóvel.
- As carteiras digitais como Apple Pay, Google Pay e Stripe Link são oferecidas quando disponíveis, para que o cliente não tenha de escrever um número de cartão.
- Após a atualização, a fatura em aberto é paga de imediato em vez de esperar pela nova tentativa seguinte.
- A página confirma o sucesso em palavras simples (“Está tudo resolvido. Cobrámos 49 $ ao seu Visa terminado em 4242.”).
Passo 5: tratar a autenticação
Algumas falhas nem sequer são recusas. Nas regiões com Strong Customer Authentication, como a UE e o Reino Unido, o banco pode exigir que o cliente confirme um pagamento com 3D Secure. O Stripe devolve authentication_required nesse caso. A solução é enviar ao cliente um link onde possa concluir a autenticação. As definições de emails aos clientes do Stripe incluem uma opção para isto. Certifique-se de que está ativa se vende a clientes europeus.
Passo 6: medir corretamente a recuperação
Não pode melhorar o que não mede, e os números de recuperação são fáceis de errar. Acompanhe estes:
| Métrica | Fórmula | Notas |
|---|---|---|
| Taxa de pagamentos falhados | Faturas falhadas / faturas tentadas | Por mês; contar apenas a primeira tentativa |
| Taxa de recuperação (número) | Faturas recuperadas / faturas que falharam | Use uma janela fixa, por exemplo 30 dias |
| Taxa de recuperação (receita) | Montante recuperado / montante que falhou | Dá mais peso aos planos maiores |
| Tempo até à recuperação | Dias desde a primeira falha até ao pagamento | Mais curto quer dizer menos perturbação para os clientes |
| Recuperado por canal | Novas tentativas vs clique no email vs resposta do suporte | Diz-lhe onde investir |
Algumas regras mantêm os números honestos:
- Use coortes. Conte as falhas de um dado mês e acompanhe se essas faturas concretas foram pagas, em vez de comparar “pagamentos recuperados este mês” com “falhas este mês”.
- Exclua o que teria sido pago de qualquer forma. Se comparar ferramentas ou definições, aplique-as a grupos de falhas comparáveis.
- Separe recusas definitivas e temporárias. Uma subida da recuperação pode só querer dizer que houve menos recusas definitivas nesse mês.
- Veja o que acontece a seguir. Um cliente que paga depois de um email de recuperação e cancela na semana seguinte não foi verdadeiramente salvo.
Exemplo
Eis um exemplo hipotético, não dados reais. Uma empresa fatura 1000 faturas de subscrição em março. 60 falham na primeira tentativa, num total de 3000 $. Em 30 dias, 25 são pagas apenas com novas tentativas e 14 depois de o cliente ter atualizado o cartão a partir de um email. As outras 21 terminam em cancelamento.
- Taxa de pagamentos falhados: 60 / 1000 = 6%
- Taxa de recuperação (número): 39 / 60 = 65%
- Se as faturas recuperadas somarem 1900 $, taxa de recuperação (receita): 1900 $ / 3000 $ = 63%
Estes números dizem a esta empresa que os emails contam: mais de um terço das faturas recuperadas precisou de uma ação do cliente.
Passo 7: evitar a próxima falha
O pagamento falhado mais barato é o que nunca acontece.
- Ative as atualizações automáticas de cartões. O Stripe pode atualizar os cartões guardados quando o emissor envia novos dados (veja how cards work).
- Envie emails antes de os cartões expirarem, não depois de a renovação falhar.
- Olhe para os métodos de pagamento na inscrição. Os cartões pré-pagos e os cartões virtuais de uso único comportam-se de forma diferente dos cartões bancários. Veja cartões pré-pagos e virtuais e churn.
- Ofereça métodos de pagamento estáveis. Os débitos bancários como o Débito Direto SEPA ou as carteiras digitais podem adequar-se melhor a alguns clientes.
Checklist completa da recuperação
- Os códigos de recusa são registados e agrupados em temporários, definitivos e de autenticação.
- As Smart Retries ou um calendário personalizado estão ativos, com uma janela adequada ao seu ciclo de faturação.
- A ação no fim das novas tentativas é definida de propósito.
- Os clientes recebem um email à primeira falha, com um único link claro.
- As recusas definitivas desencadeiam um pedido imediato de novo cartão.
- São enviados links de autenticação para
authentication_required. - A página de atualização do cartão funciona no telemóvel, sem palavra-passe, com carteiras digitais.
- As respostas aos emails de recuperação chegam a uma pessoa.
- A recuperação é medida por coorte, por número e por receita.
- Os cartões a expirar são tratados antes da renovação.
Como o NoChurn ajuda
O NoChurn liga-se ao Stripe num clique e executa os passos de recuperação acima. Volta a tentar os pagamentos falhados em momentos baseados nos dias prováveis de pagamento do salário e na hora local do cliente, ou pode manter as Smart Retries do Stripe. Envia emails de recuperação nos dias 0, 3, 7 e 14 por omissão, escritos por IA no idioma do cliente e revistos antes do envio. Cada email aponta para uma página alojada de atualização do cartão; os dados do cartão ficam no Stripe e o NoChurn nunca vê números de cartão. As respostas a esses emails são lidas, classificadas e respondidas, ou enviadas à sua equipa.
O preço depende apenas do seu MRR, nunca de uma parte da receita recuperada, e é grátis até 300 $ de MRR. Veja como funciona a recuperação de pagamentos falhados ou preços.