Conciliação

Webhook pode falhar, seu servidor pode cair no meio do processamento e uma cobrança pode ser paga fora do horário que você esperava. Conciliação é a rede de proteção que pega tudo isso.

Rotina mínima

1. Baixe o extrato do período

   Exporte pelo painel: a API pública não tem rota de extrato. Uma janela com sobreposição — as últimas 48 horas, não só o dia anterior — evita buraco em virada de dia.

2. Cruze pelo identificador do pedido

   Guarde o public_id da cobrança junto do pedido, no momento em que criar a cobrança — é o que liga o movimento da KyvoPay ao pedido no seu sistema. Se você não guardou, a conciliação vira trabalho manual.

3. Separe as divergências

   Pago na KyvoPay e pendente no seu sistema, valor diferente do esperado, movimento sem pedido correspondente.

4. Corrija e registre

   Ajuste o pedido, marque a divergência como resolvida e guarde o motivo. Sem registro, o mesmo caso volta amanhã.

Sinais de que algo está errado

• Divergências crescendo dia após dia: normalmente é webhook não processado.
• Pedido pago sem evento: confira se o seu endpoint respondeu 200 na hora certa.
• Evento processado duas vezes: falta idempotência no seu lado.