Resolução

Resolver uma disputa é responder duas perguntas: o devedor tem razão? (decisão) e o que fazer com a cobrança? (efeito). A tela da disputa pede as duas, mais uma decisão fundamentada por escrito — obrigatória, porque ela vai para a trilha de auditoria.

Decisão

• Improcedente (resolved_invalid) — a cobrança está correta; o devedor não tem razão.
• Procedente (resolved_valid) — o devedor tem razão, total ou parcialmente.

Efeitos disponíveis

Efeito	O que o sistema faz	Uso típico
Retomar a régua (resume_rule)	Reativa o enrollment pausado pela disputa — a régua continua exatamente de onde parou, sem repetir etapas	Improcedente (padrão)
Ajustar o valor e retomar (adjust_amount)	Atualiza o valor atual da cobrança para o valor decidido e retoma a régua	Procedente parcial: o valor estava errado, mas a dívida existe
Cancelar a cobrança (cancel_charge)	Cobrança vira cancelled, sai da régua definitivamente, envios pendentes cancelados	Procedente: a dívida não é exigível
Baixar a dívida (write_off)	Cobrança vira written_off (baixa), enrollments encerrados	Procedente: decisão comercial de não cobrar

Sem efeito explícito, o sistema aplica o padrão coerente com a decisão: improcedente → retomar a régua; procedente → cancelar a cobrança.

O que acontece em toda resolução

Independentemente da decisão:

1. A supressão criada pela disputa é revogada — a dívida deixa de estar bloqueada por esse motivo (as demais supressões da pessoa, se houver, continuam valendo).
2. O efeito é aplicado na cobrança e na régua, conforme a tabela acima.
3. A resolução entra na timeline do cliente e na trilha de auditoria, com decisão, efeito, valor ajustado (se houver) e o texto da fundamentação.
4. O webhook dispute.resolved é emitido.

Retomada "de onde parou"

Vale destacar o comportamento da retomada: a régua não recomeça e não repete o que já foi enviado. O enrollment pausado volta a active e a verificação diária segue avaliando as próximas etapas pela idade da dívida. Se durante a disputa uma etapa "passou do ponto" (ex.: a etapa de +10 dias, e a dívida já está com 18), ela dispara na sequência, respeitando os limites de contato.

Cancelamento de disputa

Disputa aberta por engano pode ser cancelada (sem decisão de mérito): a supressão é revogada e a régua retoma de onde parou, com o cancelamento auditado e o webhook dispute.cancelled emitido.

Boas práticas

• Fundamente sempre — "contrato e ordem de serviço apresentados; cliente reconheceu a dívida" vale mais numa audiência do que qualquer print.
• Em caso de "já paguei" com comprovante válido, o caminho natural não é a disputa improcedente: registre o pagamento (a cobrança sai da régua como paga e entra no relatório de recuperação).
• Resolva dentro do SLA: cada dia de disputa aberta é um dia sem cobrar aquela dívida.