Skip to main content
POST
/
transactions
/
{hash}
/
refund
Reembolsar Transação
curl --request POST \
  --url https://api.example.com/transactions/{hash}/refund \
  --header 'Content-Type: application/json' \
  --data '
{
  "api_token": "<string>",
  "amount": 123
}
'
{
  "200": {},
  "400": {},
  "401": {},
  "404": {},
  "422": {},
  "500": {}
}

​
Visão Geral

Este endpoint permite solicitar o reembolso de uma transação que já foi paga. O reembolso pode ser total ou parcial, dependendo do valor especificado.
Apenas transações com status paid podem ser reembolsadas.

​
Endpoint

POST https://api.klivopay.com.br/api/public/v1/transactions/{hash}/refund

​
Parâmetros

​
hash
string
required
Hash identificador único da transação a ser reembolsada
​
api_token
string
required
Seu token de autenticação da API KlivoPay
​
amount
integer
Valor do reembolso em centavos. Se não informado, será feito reembolso total.Exemplo: R$ 50,00 = 5000

​
Exemplo de Requisição

curl -X POST 'https://api.klivopay.com.br/api/public/v1/transactions/abc123def456/refund' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_token": "seu_token_aqui"
  }'

​
Resposta de Sucesso

200 OK
{
  "success": true,
  "message": "Reembolso solicitado com sucesso",
  "data": {
    "transaction_hash": "abc123def456",
    "refund_amount": 5000,
    "status": "refunded",
    "refunded_at": "2025-01-21T15:30:00Z"
  }
}

​
Códigos de Resposta

​
200
OK
Reembolso processado com sucesso
​
400
Bad Request
Dados inválidos ou transação não elegível para reembolso
​
401
Unauthorized
Token de API inválido ou ausente
​
404
Not Found
Transação não encontrada
​
422
Unprocessable Entity
Valor de reembolso inválido (maior que o valor pago)
​
500
Internal Server Error
Erro interno do servidor

​
Processamento por Método de Pagamento

O reembolso via PIX é processado automaticamente e o valor é devolvido à conta de origem em até 1 hora útil.
O estorno no cartão é processado imediatamente, mas pode levar de 5 a 30 dias úteis para aparecer na fatura do cliente, dependendo da operadora do cartão.
Para reembolsos de boleto, entre em contato com o suporte para fornecer os dados bancários para transferência.
Após o reembolso, o status da transação mudará para refunded e uma notificação será enviada para o postback_url configurado.