> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kavropay.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Solicitar estorno PIX

> Solicita a devolução total ou parcial de uma cobrança PIX paga.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

Devolve valores para a conta de origem do pagador instantaneamente pelo Banco Central.

### Parâmetros de Rota (Path)

<ParamField path="id" type="string" required>
  ID da cobrança que foi paga (`PAY...`).
</ParamField>

### Parâmetros da Requisição (Body JSON)

<ParamField body="amount" type="string">
  Valor a ser estornado (ex: `"50.00"`). Se omitido, estorna 100% do valor da transação.
</ParamField>

<ParamField body="reason" type="string">
  Motivo da devolução registrado no histórico Bacen.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.kavropay.online/v1/charges/PAY8829F1A4BC/refund \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
    -H "Content-Type: application/json" \
    -d '{
      "amount": "50.00",
      "reason": "Devolução solicitada pelo comprador"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "refundId": "ref_90df21a5",
    "chargeId": "PAY8829F1A4BC",
    "status": "completed",
    "amountRefunded": "50.00",
    "remainingAmount": "50.00",
    "refundedAt": "2026-09-30T09:40:00.000Z"
  }
  ```
</ResponseExample>