Skip to main content
POST
Criar Saque
Cria uma solicitação de saque do seu saldo disponível. O header Idempotency-Key é obrigatório. Saques acima de R$ 5.000 devem incluir dados do beneficiário (Travel Rule, compliance BACEN).
string
required
Sua API Key (sk_live_...). Veja Autenticacao.
string
required
Chave única para esta requisição (UUID v4, max 128 chars).Exemplo: 550e8400-e29b-41d4-a716-446655440000
string
Token de confirmação 2FA. Obrigatório quando o usuário dono da credencial tem 2FA ativo — inclusive em chamadas via API Key. Sem ele, a API retorna 403 MFA_REQUIRED.
integer
required
Valor do saque em centavos. Mínimo: 500 (R$ 5,00).Exemplo: 50000 (equivale a R$ 500,00)
string
required
Método de saque. Valor aceito atualmente: PIX (transferência instantânea via chave PIX, disponível 24/7).
string
required
Chave PIX do destinatário. Aceita CPF, CNPJ, e-mail, telefone ou chave aleatória (EVP).Exemplo: [email protected]
string
required
Tipo da chave PIX. Valores: CPF, CNPJ, PHONE, EMAIL, EVP.
  • CPF: 11 dígitos (pontuação é ignorada)
  • CNPJ: 14 caracteres — numérico ou alfanumérico (novo CNPJ, com letras nas 12 primeiras posições e 2 dígitos verificadores). Pontuação é ignorada.
  • PHONE: telefone brasileiro. Recomendado o formato E.164 +5511999999999, mas também aceitamos sem o + (5511999999999) ou só DDD + número (11999999999) — normalizamos para E.164 automaticamente.
  • EMAIL: endereço de e-mail válido
  • EVP: chave aleatória UUID
object
Objeto JSON livre para dados do seu sistema.Exemplo: {"order_id": "ORD-2024-001"}
string
Descrição ou motivo do saque. Max 140 chars recomendado.Exemplo: Repasse referente ao período de março/2024
string
Nome completo do beneficiário. Obrigatório para compliance quando valor acima de R$ 5.000 (Travel Rule).
string
Tipo do documento do beneficiário. Valores: CPF, CNPJ.
string
Número do documento do beneficiário. CPF: 11 dígitos. CNPJ: 14 caracteres (numérico ou alfanumérico). Pontuação é ignorada.

Resposta

boolean
true quando o saque foi criado com sucesso.
string
Identificador único do saque.
integer
Valor do saque em centavos. A tarifa do saque é debitada do saldo separadamente, conforme o plano contratado.
string
Status inicial: PENDING.
Novos valores podem ser adicionados a este campo. Trate valores desconhecidos como fallback. Não faça switch exaustivo.

Exemplo de resposta