Skip to main content
Saiba como realizar o reembolso total ou parcial de um pagamento Pix já efetuado usando a API Pagou.ai.
Este endpoint permite reembolsar transações Pix com status “PAID” e até 90 dias após o pagamento, desde que haja saldo suficiente.

​
Endpoint de produção

​
/pix/v1/payment/refund/:id
Endpoint para reembolso de pagamento Pix.
POST https://api.pagou.ai/pix/v1/payment/refund/:id
1

Enviar requisição de reembolso

Realize uma requisição POST para o endpoint acima, informando o ID da transação a ser reembolsada.
2

Aguardar resposta

Aguarde a resposta da requisição. Se o reembolso for realizado com sucesso, você receberá o ID da transação reembolsada.
3

[Opcional] Verificar saldo

Verifique o saldo da sua conta para garantir que haja saldo suficiente para cobrir o estorno.
4

[Opcional] Aumentar saldo

Aumente o saldo da sua conta para cobrir o estorno.
5

[Opcional] Reembolsar novamente

Reembolse novamente a transação.
As taxas referentes à cobrança não são devolvidas em caso de estorno. Portanto, caso você tenha acabado de receber uma cobrança em Pix e tente estornar o valor total, poderá retornar erro 400 e será necessário aumentar o próprio saldo para conseguir o estorno total caso sua conta não possua saldo suficiente para cobrir o estorno.

​
Parâmetros da requisição

​
Headers

​
Content-Type
string
required
Sempre envie como application/json.
​
apiKey
string
required
Sua chave de API. Exemplo: sk_live_1234

​
Parâmetros de rota

​
id
string
required
Identificador único da transação a ser reembolsada.
A transação deve ter status “PAID”, ter no máximo 90 dias e saldo suficiente para devolução.

​
Body (JSON)

​
value
number | float
Valor a ser reembolsado (parcial). Se não informado, o reembolso será total. O valor máximo permitido é o valor da transação.
​
description
string
Descrição a ser exibida no comprovante de reembolso.
curl --request POST \
  --url https://api.pagou.ai/pix/v1/payment/refund/<id> \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <sua-chave-api>' \
  --data '{
    "value": 50.20,
    "description": "Sua descrição"
}'

{
  "transactionId": "84ad3b3b-65a5-4091-a291-a2ff37dfbf03"
}
​
transactionId
string
required
Identificador único da transação reembolsada.