Criar Saque PIX
Cria um novo saque via PIX informando os dados da chave PIX e do titular da conta destino.
Permissão requerida: WITHDRAWAL:WRITE ou FULL_ACCESS
Restrição de IP: Se a credencial tiver uma lista de IPs permitidos configurada, requisições fora dela são rejeitadas com 403. Recomendado para credenciais com esta permissão.
Autorizações
Access token obtido no POST /auth (client_id + client_secret). Válido por 300 segundos.
Cabeçalhos
Chave única do cliente (8-255 chars) que torna a requisição idempotente. Retentativas com a mesma chave retornam a resposta cacheada (TTL 24h). Mesma chave com body diferente retorna 422.
8 - 255Corpo
Dados para criar um saque via PIX. Informe exatamente um entre amount (valor bruto debitado do saldo) ou netAmount (valor líquido que o destinatário deve receber).
Chave PIX do destinatário.
"12345678901"
Tipo da chave PIX.
cpf, cnpj, email, phone, random "cpf"
Nome do titular da conta PIX.
"João da Silva"
CPF ou CNPJ do titular.
"12345678901"
Tipo do documento do titular.
cpf, cnpj "cpf"
Valor bruto em BRL debitado do saldo. O destinatário recebe amount - feeAmount. Mínimo R$ 1,00. Informe amount OU netAmount — nunca os dois.
x >= 1150.75
Valor líquido em BRL que o destinatário deve receber. A API calcula o gross necessário (gross = netAmount + feeAmount) e debita esse total do saldo. Mínimo R$ 1,00. Informe amount OU netAmount — nunca os dois.
x >= 1150
Seu ID de referência externa (opcional). É devolvido no response e nos webhooks withdrawal_completed e withdrawal_failed para facilitar a reconciliação com seus sistemas internos.
255"saque-empresa-001"
Resposta
Saque criado com sucesso
Dados do saque criado.
ID do saque
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Valor do saque em BRL
150.75
Valor da taxa em BRL
2.5
Valor líquido em BRL
148.25
Status do saque
pending, processing, completed, failed "completed"
Nome do titular no momento do saque
"João da Silva"
Documento do titular no momento do saque
"12345678901"
Data de criação
"2026-02-10T14:30:00.000Z"
Chave PIX usada no momento do saque
"12345678901"
Tipo da chave PIX usada no momento do saque
cpf, cnpj, email, phone, random "cpf"
Motivo da falha (quando status = failed)
null
Referência do PSP (provedor de pagamento)
null
Data de processamento
"2026-02-10T14:30:01.000Z"
Sua referência externa enviada na criação do saque (opcional)
"saque-empresa-001"

