Chargebacks com o Recurly: o que o Recurly mostra e onde responder

O Recurly fatura os seus clientes, mas o pagamento por cartão propriamente dito passa por um gateway como o Stripe ou a Adyen. Quando um cliente contesta uma cobrança, essa divisão decide tudo: a disputa é aberta e respondida no gateway, e o Recurly regista as consequências na fatura e na subscrição. Este guia explica o que o Recurly mostra, o que faz por si e onde responde de facto.

Baseia-se na documentação do próprio Recurly: chargeback management for cards, chargebacks and late failures for direct debit, a página do gateway Stripe, o transactions dashboard e subscription notifications (todos consultados em novembro de 2026). Quando a documentação do Recurly não diz nada, assinalamo-lo.

Quem faz o quê

Passo	Onde acontece
O titular do cartão contesta a cobrança	O seu banco, depois a rede de cartões
A disputa é aberta e você é notificado	O seu gateway
Envia provas ou aceita	O seu gateway, no dashboard ou na API
O banco decide	Banco e rede
A fatura e a subscrição são atualizadas	O Recurly, se a gestão de chargebacks estiver ativa

A página de chargebacks do Recurly é explícita quanto à resposta: o comerciante contesta ou aceita o chargeback através do seu gateway. O Recurly não envia provas por si.

A gestão nativa de chargebacks de cartão do Recurly

Disponibilidade

Segundo a documentação do Recurly, a gestão nativa de chargebacks de cartão está em early access: pede ao Recurly Support ou ao seu account manager que a ative. Está disponível em três gateways:

• Adyen: ative os tipos de webhook da Adyen CHARGEBACK, SECOND_CHARGEBACK e DISPUTE_DEFENSE_PERIOD_ENDED. O Recurly indica que alguns estados da Adyen só chegam depois de agir no dashboard da Adyen.
• Chase Orbital: a Chase dá ao Recurly acesso aos seus relatórios de chargebacks usando o Partner ID do Recurly; não há nada a configurar dentro do Recurly.
• Stripe: o estado do chargeback e o código de motivo aparecem na Admin UI do Recurly, e o Recurly remete para os códigos de motivo do Stripe para o seu significado. A página do Stripe do Recurly diz que os eventos de webhook que usa não exigem configuração adicional no Stripe.

Para os outros gateways, a documentação que encontrámos não descreve uma gestão nativa de chargebacks, e pelo menos uma página de gateway (Ebanx) diz que os chargebacks não são refletidos. Verifique a página do seu gateway na documentação do Recurly.

O que o Recurly faz, e quando

O Recurly atua quando o chargeback chega a um estado final: aceite, perdido ou expirado. Nesse momento recebe do gateway um evento “Chargeback Completed” e:

1. cria uma fatura de reembolso externa, com origem Chargeback;
2. cria uma transação de chargeback, que aparece com o estado Chargeback no transactions dashboard;
3. faz expirar a subscrição associada. Outra parte da documentação do Recurly diz que as subscrições afetadas “podem” expirar automaticamente consoante as suas definições, por isso verifique como estão configuradas as suas.

Daqui decorrem duas consequências. Primeiro, nada muda no Recurly enquanto a disputa está aberta; a subscrição continua a renovar, a menos que aja. Segundo, a documentação do Recurly que encontrámos não descreve o que acontece no Recurly quando ganha uma disputa, já que as ações estão ligadas aos estados aceite, perdido e expirado. Se ganhar, verifique você mesmo a fatura e a subscrição.

Um sistema de chargebacks de cada vez

O Recurly suporta ferramentas de chargebacks de terceiros como alternativa, mas só um sistema pode estar ativo por site. Quando uma ferramenta de terceiros está ativa, o Recurly deixa de processar os eventos de chargeback dos gateways suportados. Escolha uma única fonte de verdade.

O débito direto é diferente

Nos débitos bancários, a página sobre débito direto do Recurly descreve os chargebacks e as falhas tardias, com a GoCardless como exemplo principal e dois modos:

• Modo por omissão: quando o Recurly recebe o webhook do chargeback, cria ele próprio uma transação de reembolso.
• Modo manual: o Recurly envia uma notificação por webhook para cada chargeback e não faz nada; é você que decide o que fazer. Neste modo, o filtro de estado Chargeback na página de transações não devolve nada, porque não são criadas transações de reembolso de chargeback.

O Recurly indica que as Webhook Options do gateway têm de estar ativas para que o tratamento automático funcione. Nos dois modos, envia um webhook para cada evento de chargeback.

Onde responde: no gateway

Como a resposta acontece no gateway, é o seu processo aí que decide o resultado. Se o seu gateway for o Stripe, explicamos o ciclo de vida das disputas, os campos de provas e os prazos em como ganhar chargebacks no Stripe. Seja qual for o gateway, as provas de um negócio de subscrições vêm em grande parte de sítios onde o Recurly pode ajudar:

• Histórico da subscrição: quando o cliente se inscreveu, em que plano, quantas renovações pagou sem contestar. As páginas de conta e de faturas do Recurly guardam isto.
• Registo do cancelamento: se a disputa diz “eu cancelei”, o Recurly tem canceled_at e expires_at da subscrição, e a notificação canceled que recebeu. Se não houver cancelamento, isso também é uma prova.
• Termos mostrados na inscrição, incluindo como cancelar e quando acontecem as renovações.
• Emails enviados: emails de fatura, de renovação ou de recuperação que foram para o cliente, enviados pelo Recurly ou por si.
• Utilização: inícios de sessão e atividade no seu produto durante o período cobrado. Isto está nos seus sistemas, não no Recurly.
• Conversas de suporte com o cliente, a partir do seu helpdesk.

Um processo que funciona

1. Conheça o suporte do seu gateway. Verifique se o seu gateway é um dos três com gestão nativa e se está ativa no seu site.
2. Receba a notificação no gateway, não no fim. O Recurly atua no estado final; nessa altura, o prazo para as provas já passou. Subscreva as notificações de disputas no próprio gateway.
3. Decida já o que fazer com a subscrição. Se o titular diz que a cobrança não foi feita por ele, a próxima renovação nesse cartão provavelmente também será contestada. Pondere cancelar a subscrição no Recurly enquanto a disputa está aberta, em vez de esperar que o Recurly a faça expirar.
4. Reúna as provas no Recurly e nos seus próprios sistemas e responda no gateway antes do prazo.
5. Reconcilie no fim. Quando o Recurly criar a fatura de reembolso e a transação de chargeback, verifique se o estado da subscrição corresponde ao que decidiu, e trate à mão as disputas ganhas.
6. Procure padrões. As disputas por “subscrição cancelada” apontam para um processo de cancelamento difícil de encontrar ou não cumprido; as disputas por cobrança “não reconhecida” apontam para o seu descritor de pagamento ou para a falta de lembretes de renovação.

Fazer isto com o NoChurn

Com o Recurly, as disputas vêm do gateway que está por trás dele. Se esse gateway for o Stripe ou o Braintree, o NoChurn lê a disputa, reúne as provas automaticamente (respostas ao fluxo de cancelamento, emails enviados pelo NoChurn, utilização que envia pela API e conversas de um helpdesk ligado, em modo só de leitura) e redige com IA uma resposta que só é enviada ao gateway depois de uma pessoa da sua equipa a rever. A decisão do banco, as taxas e os prazos ficam com o gateway e as redes, e as faturas e as subscrições ficam no Recurly. O NoChurn acrescenta também fluxos de cancelamento com um cancelamento num clique sempre visível, o que ajuda a evitar as disputas do tipo “eu cancelei”. Veja NoChurn + Recurly.