Solicitar devolução
Checkout Transparente
Solicitar Devolução
Solicita a devolução integral de uma cobrança paga. Não há body —
o id da cobrança é passado via query string. Não existe devolução parcial.
Regras:
- A cobrança precisa estar com status
PAID - A cobrança ainda não pode ter sido devolvida integralmente
- O merchant precisa ter saldo disponível para cobrir o valor (a taxa cobrada não é devolvida)
POST
Solicitar devolução
Solicita a devolução integral de uma cobrança paga.
Exemplo:
Resposta:
Pré-requisitos
- A cobrança precisa estar com
status = PAID - A cobrança ainda não pode ter sido devolvida integralmente
- O merchant precisa ter saldo disponível para cobrir o valor
Como funciona
1
Validamos o saldo
O valor da cobrança é debitado do saldo
available do merchant.2
Criamos o registro de refund
Status inicial:
PENDING.3
Disparamos para o PSP
Solicitação assíncrona ao banco/PSP usando o
end2endId da cobrança.4
Atualizamos o status
COMPLETED quando o PIX de devolução for confirmado, ou FAILED se
houver erro — acompanhe pelo webhook REFUND_COMPLETED/REFUND_FAILED.Erros comuns
Authorizations
Autentique suas requisições enviando o token no header
Authorization: Bearer <token>.
O token pode ser:
- Uma API key com prefixo
liq_, gerada em Dashboard Liquerapay → Configurações → API Keys. - Um JWT retornado pelo login do dashboard (uso interno).
Não há distinção de ambiente — toda chave vale para o único ambiente disponível (produção).
Query Parameters
Example:
"chg_018f8e2d9a5f7b10c3d4"