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 contestação. 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

Vale reforçar aqui o que já está na visão geral do objeto: não existe fechamento automático quando o prazo em evidence_details.due_by vence. Se você simplesmente não fizer nada, o dispute continua parado no mesmo status indefinidamente, até que a decisão chegue por fora ou alguém chame close. Ou seja, “deixar o prazo vencer” não encerra o caso sozinho — se a intenção é desistir de verdade (por exemplo, porque não vale a pena reunir a documentação, ou porque o valor contestado é baixo), chamar close é o jeito de refletir isso no objeto. Caso contrário, o dispute fica aberto e reportando past_due desatualizado até a próxima atualização vinda 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 enviar evidência para esse caso (tentar submit: true 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
required
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.