Estornar Cobrança
Cobranças
Estornar Cobrança
Estorne uma cobrança paga, total ou parcialmente
POST
Estornar Cobrança
Visão Geral
Estorna uma cobrança já paga. O estorno pode ser total (omitindoamount) ou parcial.
Só cobranças com status
paid podem ser estornadas. Para cancelar uma cobrança que ainda não foi paga (pending), use DELETE /api/v1/charges/{uuid}.Headers
string
required
Sua chave de API (
Bearer sk_live_...)string
required
application/jsonPath Parameters
string
required
UUID da cobrança
Request Body
number
Valor a estornar em BRL decimal (ex:
50.00, não 5000). Omita para estornar o total cobrado.string
Motivo do estorno, até 500 caracteres. Fica registrado na cobrança.
Exemplo de Requisição
Resposta de Sucesso (200 OK)
A cobrança atualizada, agora com o blocorefund preenchido:
Estorno de Pix Automático
Cobranças de Pix Automático são estornadas via devolução — uma transferência Pix de volta, regida por regras do Banco Central. Isso muda o comportamento em um ponto importante:A devolução não é instantânea. A resposta confirma que o estorno foi solicitado, não concluído.A cobrança fica com
status: "refundPending" e o bloco refund já traz o valor, mas com refundedAt: null. Quando a transferência liquida, o status vira reversed, o refundedAt é preenchido e o webhook transaction.refunded é disparado.Use refundedAt como o sinal de que o dinheiro voltou de fato — não a resposta desta chamada.Estorno de PIX (Celcoin) não é suportado
A Celcoin não oferece devolução de PIX: a API dela expõe estorno apenas para cartão e boleto, e o painel não mostra ação de estorno para um PIX pago. Um estorno de PIX processado pela Celcoin não é possível por aqui — a API recusa na hora, sem sequer tentar o provedor.422 Unprocessable Entity