Visão geral
Este artigo cobre o que acontece depois que a cobrança é enviada: como devolver dinheiro (reembolso), como o webhook mantém os status sincronizados sem você fazer nada e quais relatórios mostram a saúde financeira da operação.
O webhook é o canal pelo qual o gateway avisa a plataforma a cada mudança (pago, vencido, reembolsado, cancelado). Por isso ele é a fonte da verdade: a plataforma atualiza o status da cobrança a partir do webhook, não da tela de "sucesso" do checkout.
Pré-requisitos
- Módulo Pagamentos habilitado e um gateway conectado com webhook configurado.
- Permissão para emitir reembolsos.
- Para os relatórios, ter cobranças/assinaturas registradas no período.
Passo a passo
Reembolsar uma cobrança
- Abra a cobrança que deseja reembolsar (já paga).
- Escolha reembolsar.
- Selecione total (devolve o valor inteiro) ou parcial (informe o valor a devolver).
- Confirme. A plataforma solicita o reembolso ao gateway.
- Acompanhe o status mudar para reembolsado (ou parcialmente reembolsado) quando o gateway confirmar.
Verificar o webhook
- Nas configurações da conexão do gateway, confira a URL do webhook e o segredo de verificação.
- Garanta que a URL esteja registrada no painel do gateway.
- Faça um teste e veja o status atualizar automaticamente.
Ler os relatórios
- Abra os relatórios de Pagamentos.
- Filtre por período.
- Analise os indicadores (faturamento, ticket médio, MRR, churn) e os recortes por status, gateway e moeda.
Configurações & opções
-
Reembolso total × parcial: ambos suportados pelos gateways atuais.
-
Webhook: autenticado por cada gateway (token no cabeçalho no Asaas; assinatura no Mercado Pago); notificações repetidas são tratadas com segurança (sem duplicar efeitos).
-
Indicadores dos relatórios:
Indicador O que mostra Faturamento Total recebido no período Ticket médio Valor médio por cobrança paga Descontos concedidos Soma dos descontos aplicados Por status Distribuição entre pago, pendente, vencido, etc. Por gateway Quanto entrou por Asaas / Mercado Pago Por moeda Recortes quando há mais de uma moeda MRR Receita recorrente mensal das assinaturas ativas Churn Assinaturas canceladas no período
Casos de uso
- Devolver um valor a um cliente que desistiu (reembolso total).
- Estornar parte de uma cobrança (reembolso parcial).
- Acompanhar o crescimento de receita recorrente pelo MRR.
- Identificar perda de assinantes pelo churn.
Dicas, limites e boas práticas
- Sempre confie no webhook para o status; a tela do checkout pode renderizar antes da confirmação.
- O reembolso é processado pelo gateway — o prazo de devolução ao cliente segue as regras do provedor/meio de pagamento.
- Acompanhe MRR e churn juntos para ter a foto real da recorrência.
- Mantenha a URL do webhook acessível e o segredo de verificação correto; sem isso, os status não atualizam.
Solução de problemas
- Status nunca muda para pago: o webhook não está chegando ou foi rejeitado (assinatura/token incorretos) — reconfigure o webhook na conexão.
- Reembolso não conclui: confirme que a cobrança estava paga e que o gateway suporta o tipo de reembolso solicitado.
- Relatório vazio: verifique o filtro de período e se há cobranças no intervalo.
- MRR parece incorreto: confirme os ciclos das assinaturas; o MRR normaliza cada uma para o equivalente mensal.