Pular para o conteúdo

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.