# Saques (/docs/pix-processamento/endpoints/withdrawals)



Saques são o caminho de **saída de dinheiro**. Use chave Pix (mais comum) ou pagar um QR Code que seu cliente recebeu. Todas as transações geradas aqui são do tipo `WITHDRAW`.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/withdrawals/post_withdraw" title="Saque por chave" method="POST" path="/withdraw" />

  <QuickLink href="/docs/pix-processamento/endpoints/withdrawals/post_withdraw_qrcode" title="Pagar QR" method="POST" path="/withdraw/qrcode" />

  <QuickLink href="/docs/pix-processamento/endpoints/withdrawals/get_withdraw" title="Consultar saque" method="GET" path="/withdraw" />

  <QuickLink href="/docs/pix-processamento/endpoints/withdrawals/get_withdraw_proof" title="Comprovante" method="GET" path="/withdraw/proof/{id}" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                                 | Endpoint                                                                                        |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Quem é o titular dessa chave Pix?                        | [`GET /pix/key`](/docs/pix-processamento/endpoints/keys-and-dict/get_pix_key)                   |
| Quero pagar via chave Pix (cpf, cnpj, email, phone, evp) | [`POST /withdraw`](/docs/pix-processamento/endpoints/withdrawals/post_withdraw)                 |
| Recebi um QR Code do cliente, quero ler antes de pagar   | [`POST /pix/qrcode/read`](/docs/pix-processamento/endpoints/keys-and-dict/post_pix_qrcode_read) |
| Quero pagar um QR Code direto                            | [`POST /withdraw/qrcode`](/docs/pix-processamento/endpoints/withdrawals/post_withdraw_qrcode)   |
| O saque foi concluído? Qual o status agora?              | [`GET /withdraw`](/docs/pix-processamento/endpoints/withdrawals/get_withdraw)                   |
| Quero o comprovante oficial do saque                     | [`GET /withdraw/proof/{id}`](/docs/pix-processamento/endpoints/withdrawals/get_withdraw_proof)  |

<Callout type="info">
  PayZu processa QR Code **dinâmico** e **estático** na leitura e pagamento.
</Callout>

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="POST /withdraw, saque por chave email">
    ```bash
    curl -X POST https://api.payzu.processamento.com/v1/withdraw \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": 250.00,
        "pixKey": "joao@example.com",
        "pixType": "email",
        "callbackUrl": "https://seusite.com.br/webhooks/payzu",
        "clientReference": "payout-2025-08-001"
      }'
    ```
  </Accordion>

  <Accordion title="GET /pix/key, validar titular antes de pagar">
    ```bash
    curl "https://api.payzu.processamento.com/v1/pix/key?key=joao@example.com" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json"
    ```
  </Accordion>

  <Accordion title="POST /withdraw/qrcode, pagar um QR">
    ```bash
    curl -X POST https://api.payzu.processamento.com/v1/withdraw/qrcode \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "qrCode": "00020126870014br.gov.bcb.pix...",
        "amount": 100.00,
        "callbackUrl": "https://seusite.com.br/webhooks/payzu",
        "clientReference": "payout-qr-2025-08-001"
      }'
    ```
  </Accordion>
</Accordions>

## Fluxo recomendado (por chave) [#fluxo-recomendado-por-chave]

<Mermaid
  chart="`
flowchart LR
  A[&#x22;GET /pix/key&#x22;] --> B[&#x22;Confirma titular&#x22;]
  B --> C[&#x22;POST /withdraw&#x22;]
  C --> D[&#x22;Callback COMPLETED&#x22;]
  D --> E[&#x22;GET /withdraw/proof&#x22;]

  click A &#x22;/docs/pix-processamento/endpoints/keys-and-dict/get_pix_key&#x22; &#x22;GET /pix/key&#x22;
  click C &#x22;/docs/pix-processamento/endpoints/withdrawals/post_withdraw&#x22; &#x22;POST /withdraw&#x22;
  click D &#x22;/docs/pix-processamento/webhooks&#x22; &#x22;Webhooks&#x22;
  click E &#x22;/docs/pix-processamento/endpoints/withdrawals/get_withdraw_proof&#x22; &#x22;Comprovante&#x22;

  style C fill:#f59e0b,stroke:#d97706,color:#ffffff
  style D fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## Limites mínimos [#limites-mínimos]

| Operação                                                                                      | `amount` mínimo |
| --------------------------------------------------------------------------------------------- | --------------- |
| [`POST /withdraw`](/docs/pix-processamento/endpoints/withdrawals/post_withdraw)               | R$ 0,01         |
| [`POST /withdraw/qrcode`](/docs/pix-processamento/endpoints/withdrawals/post_withdraw_qrcode) | R$ 0,10         |

## Tutoriais e boas práticas [#tutoriais-e-boas-práticas]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/tutoriais/send-pix" title="Tutorial: Enviar Pix" />

  <QuickLink href="/docs/pix-processamento/endpoints/keys-and-dict" title="Chaves e DICT" />

  <QuickLink href="/docs/pix-processamento/best-practices/dict" title="Consulta DICT" />

  <QuickLink href="/docs/pix-processamento/best-practices/security" title="Segurança em saques" />
</QuickLinks>