> ## 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/cash-out

> Criar envio por chave Pix; 201 com estado pós-reserva e pipeline (ver status-model).

## Resumo

* **Método:** `POST`
* **Rota:** `/api/pix/cash-out`
* **Autenticação:** `Authorization: Bearer <seu_api_token>`

## Corpo (exemplo documentado)

```json theme={null}
{
  "transaction": {
    "value": 500.00,
    "externalId": "saque-789",
    "description": "Pagamento Fornecedor ABC"
  },
  "recipient": {
    "name": "Maria Oliveira",
    "document": "987.654.321-00",
    "pixKey": "maria@email.com",
    "pixKeyType": "email"
  }
}
```

## Resposta `201`

```json theme={null}
{
    "id": "977a38e8-4004-41a0-8ce0-08daaf337e8f",
    "externalId": "aaa00335-5f00-4697-b30b-88948dfb5d23",
    "status": "RESERVED",
    "valueCents": 2,
    "description": "cash-out",
    "recipient": {
        "name": "Lulu",
        "pixKey": "87a9b91f-f1f0-4acf-963d-fc58172fe412"
    },
    "createdAt": "2026-04-22T20:37:48.336039168Z"
}
```

| Campo              | Descrição                                                                                     |
| ------------------ | --------------------------------------------------------------------------------------------- |
| `id`               | UUID do cash-out — **persista** para polling e reconciliação.                                 |
| `externalId`       | Seu identificador enviado no request.                                                         |
| `status`           | `RESERVED` logo após a criação (reserva de saldo efetuada). O estado final chega via webhook. |
| `valueCents`       | Valor em **centavos** (ex.: `2` = R\$ 0,02).                                                  |
| `description`      | Descrição enviada no request.                                                                 |
| `recipient.name`   | Nome do destinatário.                                                                         |
| `recipient.pixKey` | Chave Pix usada (EVP no exemplo).                                                             |
| `createdAt`        | Timestamp ISO 8601 UTC da criação.                                                            |

## HTTP

* **201** Criado.
* **400/422/409** Conforme regras.
* **401** Não autenticado.
* **500** Interno.

## Relacionado

* [Enviar por chave (guia)](/guides/send-pix-cash-out-key)
* [Listar e obter detalhe](/api-reference/list-cash-outs)