> ## 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 saque PIX

> Transfere saldo disponível instantaneamente para qualquer chave PIX externa do Banco Central.

<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>

Permite transferir saldo disponível da sua Conta Master para qualquer chave PIX em menos de 3 segundos com conciliação automática.

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

<ParamField body="amount" type="string" required>
  Valor do saque em Reais como string decimal (ex: `"150.00"`). Também aceita `amountCents: 15000`.
</ParamField>

<ParamField body="pix_key" type="string" required>
  Valor da chave PIX de destino (CPF, CNPJ, E-mail, Celular ou Chave Aleatória EVP).
</ParamField>

<ParamField body="pix_key_type" type="string" required>
  Tipo da chave: `CPF`, `CNPJ`, `EMAIL`, `PHONE` (ou `TELEFONE`), `EVP`.
</ParamField>

<ParamField body="description" type="string">
  Mensagem opcional exibida no comprovante do recebedor (máx: 140 caracteres).
</ParamField>

<ParamField body="externalId" type="string">
  Identificador único da operação no seu sistema.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.kavropay.online/v1/withdrawals \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: wth_12345" \
    -d '{
      "amount": "150.00",
      "pix_key": "12345678909",
      "pix_key_type": "CPF",
      "description": "Pagamento de comissão"
    }'
  ```

  ```javascript Node.js theme={null}
  const res = await fetch('https://api.kavropay.online/v1/withdrawals', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI',
      'Content-Type': 'application/json',
      'Idempotency-Key': 'wth_12345'
    },
    body: JSON.stringify({
      amount: "150.00",
      pix_key: "12345678909",
      pix_key_type: "CPF",
      description: "Pagamento de comissão"
    })
  });
  const data = await res.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "WTH9182A45C",
    "status": "processing",
    "amount": 150.00,
    "fee": 1.00,
    "pix_key": "12345678909",
    "pix_key_type": "CPF",
    "created_at": "2026-09-30T09:45:00.000Z"
  }
  ```
</ResponseExample>