Devolve uma cobrança de cartão, total ou parcialmente
POST/integration/v1/charges/:charge/refund
Só cartão. A devolução de PIX tem regras próprias do arranjo e não compartilha nem o caminho nem a decomposição — tratar as duas no mesmo endpoint faria uma delas ficar errada em silêncio.
Sem amount, devolve o que resta. Devoluções parciais somam: o que
ainda pode ser devolvido é amount − refundedAmount.
Requisição
Respostas
- 201
- 401
- 403
- 404
- 422
Devolução registrada.
error.code = invalid_signature. Cobre chave desconhecida, assinatura
incorreta, cabeçalho ausente, instante fora da tolerância de 300s e
nonce repetido — deliberadamente indistinguíveis, para não
transformar o endpoint num verificador de quais chaves existem.
A cobrança não é de cartão, ou o valor excede o que resta.
error.code = forbidden.
Recurso inexistente — ou que o solicitante não tem por que saber que existe. Usado também onde 403 seria a resposta "correta" em teoria: dizer "existe mas você não pode" entrega informação a quem sonda.
error.details traz um mapa campo → lista de mensagens.