Criar Saque

Cria uma nova solicitação de saque via PIX.

⚠️ Importante

Use sempre o header Idempotency-Key para evitar saques duplicados

Valores devem ser enviados em centavos (ex: 254 = R$ 2,54)

O postbackUrl é opcional mas recomendado para receber notificações

Status possíveis na criação

pending - Aguardando aprovação manual

approved - Aprovado automaticamente para processamento

failed - Falha na criação do saque

refused - Recusado

cancelled - Cancelado

processing - Em processamento

Casos de erro comuns

400 - Dados inválidos (chave PIX, valor, etc.)

401 - Credenciais inválidas

429 - Muitas requisições (aguarde 10 segundos)

500 - Erro interno do servidor

Requisição

Authorization

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Correto

application/json

Saque criado com sucesso.

O status inicial pode ser pending (aguardando aprovação) ou approved (aprovado automaticamente).

Headers

Body

🟠400Solicitação incorreta

🟠401Não autenticado

🟠429Solicitações demais

🔴500Erro interno do servidor

curl --location --request POST 'https://api.fullpix.com.br/functions/v1/withdrawals/cashout' \ --header 'Idempotency-Key;' \ --header 'Authorization: Basic <encoded-value>' \ --header 'Content-Type: application/json' \ --data-raw '{ "pixkeytype": "CPF", "pixkey": "99999999999", "requestedamount": 254, "description": "Saque via API", "isPix": true, "postbackUrl": "https://webhook.site/unique-id" }'

{ "event": "withdrawal.created", "timestamp": "2025-07-10T17:40:27.885Z", "withdrawal": { "id": "756d4eec-9a22-44b0-a514-a27c366c5433", "company_id": "5e1ce642-b9f1-433c-a350-5f9cd3d16bf6", "requested_amount": 2.54, "currency": "BRL", "status": "pending", "created_at": "2025-07-10T14:40:26.270543", "updated_at": "2025-07-10T14:40:26.270543", "pix": { "key_type": "CPF", "key_value": "99999999999" }, "fee": 0, "net_amount": 2.54 }, "metadata": { "source": "withdrawals_service", "version": "1.0.0" } }

⚠️ Importante#

Status possíveis na criação#

Casos de erro comuns#

Requisição

Respostas

⚠️ Importante

Status possíveis na criação

Casos de erro comuns