curl --request POST \
--url https://api.usevext.com/v1/withdrawals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 50000
}
'{
"object": "withdrawal",
"id": "wd_01k1y8d4h1g2f3e4d5c6b7a8z9",
"status": "awaiting_approval",
"method": "pix",
"amount": 50000,
"currency": "BRL",
"fee": 367,
"net": 49633,
"pix_key_type": "email",
"pix_key": "fi********@fornecedor.com.br",
"failed_reason": null,
"created_at": "2026-10-27T14:02:00+00:00",
"processed_at": null
}Solicitar saque
Tira dinheiro do saldo: PIX para uma chave no bolsão, TED para a conta bancária no split.
curl --request POST \
--url https://api.usevext.com/v1/withdrawals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 50000
}
'{
"object": "withdrawal",
"id": "wd_01k1y8d4h1g2f3e4d5c6b7a8z9",
"status": "awaiting_approval",
"method": "pix",
"amount": 50000,
"currency": "BRL",
"fee": 367,
"net": 49633,
"pix_key_type": "email",
"pix_key": "fi********@fornecedor.com.br",
"failed_reason": null,
"created_at": "2026-10-27T14:02:00+00:00",
"processed_at": null
}10000. Decimais são
recusados com 422, e o porquê está em Valores em centavos.Idempotency-Key nesta chamada e você pode repetir com tranquilidade depois de um erro de
rede: a mesma chave devolve o recurso que já existe, em vez de criar um segundo.
Veja Idempotência.pix_key_type, e um valor de outro tipo é recusado — nunca
reclassificado. Com o saque automático desligado, o saque fica em awaiting_approval até a Vext
aprovar. Destino por modelo, tipos de chave e recusas em Saques.Authorizations
Chave secreta do vendedor, criada no painel em Desenvolvedores.
O valor em claro existe uma única vez, na criação. Guardamos só o hash SHA-256 - nem o suporte consegue recuperá-lo, o que é o ponto: um dump do nosso banco não permite cobrar em nome de ninguém.
A chave vai no servidor. Colocá-la no navegador do comprador a entrega a qualquer pessoa que abra a página.
Headers
Identificador único da SUA tentativa. Use o mesmo valor ao repetir a requisição depois de um erro de rede.
Opcional, mas recomendado em toda criação de cobrança e estorno. Sem ele, uma repetição cria uma segunda cobrança.
255Body
O que sai do saldo, em centavos inteiros. A taxa vem de dentro deste valor.
50000
Obrigatório junto com pix_key. Só para contas no modelo bolsão.
cpf, cnpj, email, phone, random, evp A chave, do tipo declarado. CPF e CNPJ têm o dígito verificador
conferido; telefone aceita com ou sem +55; e-mail é gravado em
minúsculas. Obrigatório junto com pix_key_type.
77"financeiro@fornecedor.com.br"
Response
Saque registrado e saldo debitado.
Um saque. amount, fee e net são centavos inteiros, e sempre
net = amount - fee. A chave PIX vem mascarada.
"withdrawal""wd_01k1y8d4h1g2f3e4d5c6b7a8z9"
pix no bolsão, ted no split.
pix, ted O que saiu do saldo.
"BRL"A taxa do saque, de dentro de amount.
O que chega ao destino.
null no saque por TED.
cpf, cnpj, email, phone, random A chave de destino, mascarada. null no saque por TED.
"fi********@fornecedor.com.br"