Para equipe ilarika
A reconciliar: dinheiro sem fatura e webhook com erro
- Super AdminAssinaturasA reconciliar
Duas coisas caem nesta fila: um pagamento que chegou do provedor sem uma fatura que o explique, e um webhook que o provedor mandou mas a aplicação falhou ao processar. Nada sai daqui sozinho: alguém decide e diz por quê.
Quando olhar
- O botão A reconciliar (N) fica em destaque no topo de Assinaturas quando há item na fila. Fila vazia mostra “Nada a reconciliar”.
- Item parado há mais de 24 h ganha a etiqueta “+24 h”, e operações recebe
um aviso no WhatsApp (número
OPS_ALERT_WHATSAPP_TO) uma vez por dia enquanto houver.
Pagamentos sem fatura
Para cada pagamento: quando chegou, provedor, referência, valor e a loja (quando o provedor informou). Entram aqui dois casos:
-
pagamento que não casou com fatura nenhuma (feito fora, referência que o sistema não conhece);
-
pagamento que casou com uma fatura mas veio com valor menor que o dela (o provedor avisou um valor abaixo do total). A fatura não é marcada como paga sozinha: é você quem decide se completa, casa mesmo assim ou devolve.
-
Casar com fatura: cole o Id da fatura aberta (copie do detalhe da assinatura) e o motivo. A fatura vira paga com esse pagamento e a loja, se estava pausada, volta na hora.
-
Reembolsar: pede ao provedor a devolução para quem pagou.
-
Ignorar: sai da fila e fica no histórico com o motivo e quem decidiu (uso típico: pagamento de teste do próprio provedor).
Webhooks com erro
Para cada webhook: quando chegou, provedor, tipo do evento e o erro.
- Reprocessar: tenta de novo com o que está gravado (sem motivo: é só repetir). Resolve a maior parte dos casos depois de corrigir a causa.
- Descartar: sai da fila com motivo; o registro bruto continua guardado.
O que acontece depois
- Casar e ignorar mudam o pagamento para “casado”; reembolsar marca como reembolsado. Tudo entra na auditoria.
- A reconciliação automática continua rodando de hora em hora: fatura com
tentativa pendente há mais de 1 h é consultada no provedor e corrigida sem
passar por esta fila. Para uma fatura só, use Consultar provedor no
detalhe da assinatura (assinaturas). A tela não tem botão
para rodar a passada inteira: só a rota
POST /platform/billing/reconciliar.
Perguntas comuns
Chegou um pagamento menor que a fatura. A fatura fica aberta e o valor aparece aqui. Se a loja pagou o resto por outro meio, case os dois com a fatura; se não, reembolse ou fale com a loja.
Casei com a fatura errada. Anule a fatura errada pelo detalhe da assinatura e marque a certa como paga com a referência do pagamento.
O webhook continua falhando depois de reprocessar. Leia o erro: quase sempre é fatura inexistente (pagamento feito fora) ou um provedor com token desatualizado. Veja o runbook de cobrança.
