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

# Iniciar Saque

> POST /v2/naas/withdraw — inicia um saque da conta do sub-merchant para um endereço na whitelist.

O destino deve estar previamente na whitelist do sub-merchant. Use [Listar Grupos de Whitelist](/pt/api-reference/naas/wl-groups) para obter o `walletId` do grupo de destino.

## Campos do payload

| Campo            | Tipo   | Obrigatório | Descrição                                        |
| ---------------- | ------ | ----------- | ------------------------------------------------ |
| `account`        | string | Sim         | Código da moeda/conta a debitar (ex: `USDT_ETH`) |
| `amount`         | string | Sim         | Valor a sacar como string decimal                |
| `wallet`         | string | Sim         | ID do grupo de carteira Fireblocks               |
| `withdrawalType` | string | Sim         | Identificador do tipo de processo de saque       |
| `note`           | string | Não         | Nota interna anexada ao processo                 |

## Response `200 OK`

```json theme={null}
{ "link": "https://checkout.noxpay.io/e2e/NOXwd123" }
```

O `link` aponta para a página do processo de saque.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://checkout.noxpay.io/v2/naas/withdraw \
    -H "api-key: <key>" \
    -H "X-Signature: <assinatura-do-corpo>" \
    -H "Content-Type: application/json" \
    -d '{
      "timestamp": "2026-05-19T14:30:00Z",
      "correlation_id": "a1b2c3d4-e5f6-4789-abcd-000000000001",
      "payload": {
        "account": "USDT_ETH",
        "amount": "500.00",
        "wallet": "fb-wallet-abc123",
        "withdrawalType": "crypto",
        "note": "Liquidação mensal"
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  body, sig = sign_envelope({
      "account":        "USDT_ETH",
      "amount":         "500.00",
      "wallet":         "fb-wallet-abc123",
      "withdrawalType": "crypto",
      "note":           "Liquidação mensal",
  }, "a1b2c3d4-e5f6-4789-abcd-000000000001")
  response = requests.post(
      "https://checkout.noxpay.io/v2/naas/withdraw",
      headers={"api-key": "<key>", "X-Signature": sig, "Content-Type": "application/json"},
      data=body,
  )
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const { body, signature } = signEnvelope({
    account:        "USDT_ETH",
    amount:         "500.00",
    wallet:         "fb-wallet-abc123",
    withdrawalType: "crypto",
    note:           "Liquidação mensal",
  }, "a1b2c3d4-e5f6-4789-abcd-000000000001");
  const response = await fetch("https://checkout.noxpay.io/v2/naas/withdraw", {
    method: "POST",
    headers: { "api-key": "<key>", "X-Signature": signature, "Content-Type": "application/json" },
    body,
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  { "link": "https://checkout.noxpay.io/e2e/NOXwd123" }
  ```
</ResponseExample>