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

# POST /api/pix/refund-in/{id}

> Solicita devolução (refund-in) — {id} é o UUID do cash-in, não o transactionId do parceiro.

## Resumo

* **Método:** `POST`
* **Rota:** `/api/pix/refund-in/{id}`
* **Autenticação:** `Authorization: Bearer <seu_api_token>`

## Path (crítico)

`{id}` = **UUID do cash-in** retornado no `POST /api/pix/cash-in` (campo `id`).

Não use o `transactionId` do BaaS neste path.

## Corpo (exemplo)

```json theme={null}
{
  "refundValue": 150.75,
  "reason": "Pedido cancelado pelo cliente",
  "externalId": "estorno-12345"
}
```

| Campo         | Obrigatório                      |
| ------------- | -------------------------------- |
| `refundValue` | Sim (BRL)                        |
| `reason`      | Não                              |
| `externalId`  | Não (pode ser gerado se omitido) |

## Regras (alto nível)

* Cash-in em **`PAID`**
* Prazo **89 dias** após o recebimento
* Soma de devoluções ≤ valor original; parciais múltiplos permitidos; competição por teto (pendentes/confirmados)

## Resposta

`201` com identificador do **refund-in** (ver implementação) — a consulta pública de refund usa o **id do refund** em `GET /api/pix/refund/{id}`.

## HTTP

* **201** Criado.
* **4xx/422** Regras de negócio (ver [mensagens](/errors/error-codes)).
* **500** Interno.

## Ver

* [Devolver (guia)](/guides/refund-a-cash-in)
* [Obter refund](/api-reference/get-refund)