Skip to main content
Encerra um dispute manualmente, marcando o resultado como lost. É a forma de você dizer “não vou brigar por esse caso” — seja porque decidiu não enviar defesa, seja porque já enviou e prefere desistir antes da análise terminar. Esse endpoint não tem uma variante de encerrar como won: fechar sempre significa conceder a disputa. Um dispute só vira won através da decisão vinda da análise, nunca por uma chamada da sua parte.

​
Quando usar close em vez de deixar o prazo vencer

Se o prazo em evidence_details.due_by vence sem nenhum campo de arquivo de evidence preenchido, o dispute é encerrado como lost automaticamente no momento do ajuste financeiro do valor contestado — você recebe charge.dispute.closed do mesmo jeito. Chamar close antecipa esse desfecho: o caso é encerrado na hora, sem esperar o ajuste, e o seu backoffice reflete a decisão imediatamente. Atenção a um detalhe: se houver campo de arquivo preenchido e defesa não enviada quando o prazo termina, a Chargefy envia a defesa automaticamente em vez de deixar o caso cair. Pra desistir de verdade de um caso que já tem arquivos na defesa, chame close antes do fim do prazo. É também o único caminho pra desistir depois de já ter enviado a defesa — um dispute em under_review não fecha sozinho antes da decisão da análise.

​
O que é irreversível aqui

Fechar um dispute é uma ação final: depois que o status vira lost, ele não volta a needs_response nem a under_review, e a organização não recebe mais chance de defender esse caso (editar evidence ou tentar enviar a defesa depois de fechado é recusado — veja a página de update). O efeito colateral também é imediato: a charge correspondente deixa de ser reembolsável (is_charge_refundable passa para false), já que o valor contestado foi concedido ao comprador.
​
string
obrigatório
ID do dispute (dp_*).

​
Erros comuns

Chamar close num dispute que já está lost não gera erro: a resposta volta 200 com o objeto tal como está, sem tentar aplicar a mudança de novo. Isso torna o endpoint seguro de chamar em retry, sem precisar checar o status antes.