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

# Reembolsos Pix

> Solicite reembolsos totais ou parciais e alinhe produto e financeiro ao estado final.

Use reembolsos para transações pagas que precisem de reversão total ou parcial.

## Operação de reembolso

`PUT /v2/transactions/{id}/refund`

## Exemplo de requisição

```bash theme={null}
curl --request PUT \
  --url https://api.pagou.ai/v2/transactions/018f1f2e-7b42-7c9a-8d3e-1a2b3c4d5e6f/refund \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 500,
    "reason": "requested_by_customer"
  }'
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "message": "Partial refund processed successfully",
    "amount_refunded": 500,
    "remaining_balance": 1000,
    "is_full_refund": false
  }
}
```

## Erro comum

Status `409`

```json theme={null}
{
  "type": "https://api.pagou.ai/problems/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "The transaction cannot be refunded in its current state."
}
```

Como corrigir: reconcilie a transação antes e permita reembolso apenas a partir de estados pagos elegíveis no seu produto e nas ferramentas operacionais.

## Regras operacionais

* Use seu próprio ID de solicitação de reembolso ou ticket para evitar ações duplicadas.
* Persista a solicitação de reembolso, o ID da transação e o status resultante da transação.
* Atualize o estado financeiro visível ao cliente apenas após confirmação por webhook ou reconciliação.

## Próximos passos

* [Status de transação](/pt/payments/transaction-statuses)
* [Eventos de pagamento](/pt/webhooks/payment-events)