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

# Solicitar saque

> Solicite um saque do saldo da loja por PIX out.

Solicita um saque e debita o saldo da loja vinculada ao token. Requer `withdrawals:write`.

<ParamField header="Idempotency-Key" type="string">
  Recomendado. Até 128 caracteres e escopo por loja.
</ParamField>

<ParamField body="amount" type="number" required>
  Valor bruto do saque, em reais.
</ParamField>

<ParamField body="pix_key_type" type="string" required>
  `cpf`, `cnpj`, `phone`, `email` ou `aleatoria`.
</ParamField>

<ParamField body="pix_key" type="string" required>
  Chave PIX de destino.
</ParamField>

<ParamField body="notification_url" type="string">
  HTTPS público para os eventos do saque.
</ParamField>

<ParamField body="notes" type="string">
  Observação interna; não é enviada no PIX.
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "amount": 50,
    "pix_key_type": "cpf",
    "pix_key": "39053344705",
    "notification_url": "https://loja.com/webhooks/agitapay"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "store": { "id": "uuid-da-loja", "name": "Padrão" },
    "status": "requested",
    "amount": 50,
    "fee": 5,
    "net": 45,
    "currency": "BRL",
    "notification_url": "https://loja.com/webhooks/agitapay"
  }
  ```
</ResponseExample>

A resposta não expõe a chave PIX. O saque exige saldo disponível, KYC aprovado, PIX ligado no admin e respeito à janela de horário da política da plataforma.
