POST /v1/merchants/me/withdrawalsSolicita a transferência do saldo disponível para uma chave PIX de destino. O saldo é deduzido imediatamente do seu saldo disponível e a transferência é enviada ao adquirente em seguida.
O status inicial do saque é PROCESSING. Quando a transferência é concluída pelo adquirente, o status atualiza para COMPLETED via webhook.
Pré-requisitos
KYC aprovado
Merchant com status ACTIVE
Conta do adquirente configurada
Saldo disponível suficiente para o valor solicitado
Request POST https://api.liquera.com.br/v1/merchants/me/withdrawals Authorization : Bearer <jwt_ou_api_key> Content-Type : application/json
Body Valor do saque em centavos . Mínimo: R$ 1,00 (100). O valor total deve estar disponível no saldo — saques parciais não são possíveis.
Tipo da chave PIX de destino. Valores aceitos: Valor Descrição CPFChave no formato CPF (11 dígitos) CNPJChave no formato CNPJ (14 dígitos) EMAILChave no formato email PHONEChave no formato telefone (+5511999998888) CHAVE_ALEATORIAChave aleatória (EVP)
Chave PIX de destino. O formato deve ser compatível com o pixKeyType informado.
Descrição opcional do saque. Máximo de 200 caracteres. Aparece nos registros internos.
Exemplos curl -X POST https://api.liquera.com.br/v1/merchants/me/withdrawals \ -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "amount": 50000, "pixKeyType": "CPF", "pixKey": "12345678901", "description": "Retirada quinzenal" }'
curl -X POST https://api.liquera.com.br/v1/merchants/me/withdrawals \ -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "amount": 150000, "pixKeyType": "EMAIL", "pixKey": "financeiro@empresa.com.br" }'
curl -X POST https://api.liquera.com.br/v1/merchants/me/withdrawals \ -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "amount": 10000, "pixKeyType": "CHAVE_ALEATORIA", "pixKey": "123e4567-e89b-12d3-a456-426614174000" }'
Response Confirmação da solicitação.
Dados do saque criado. ID único do saque no ledger. Use para rastrear o status.
Valor do saque em centavos.
Descrição informada, ou null.
Status inicial: PROCESSING.
ID do lote no adquirente, para rastreamento.
Data e hora de criação em ISO 8601.
Saldo atualizado após a dedução do saque. Saldo disponível para saque em centavos.
Saldo aguardando liquidação em centavos.
Saldo bloqueado em centavos.
Saldo total (available + pending + blocked) em centavos.
{ "message" : "Saque em processamento" , "withdraw" : { "id" : "clx5mno345" , "amount" : 50000 , "description" : "Retirada quinzenal" , "status" : "PROCESSING" , "batchId" : "batch_abc123" , "createdAt" : "2025-01-15T15:00:00.000Z" }, "balance" : { "available" : 73200 , "pending" : 15000 , "blocked" : 0 , "total" : 88200 } }
{ "message" : "Saldo insuficiente para realizar o saque" }
{ "message" : "KYC precisa estar aprovado para solicitar saque" }
{ "message" : "Valor mínimo para saque: R$ 1,00" }
Ciclo de vida do saque PROCESSING → COMPLETED → FAILED (saldo revertido automaticamente)
Se o adquirente rejeitar a transferência, o saldo é revertido automaticamente para o seu saldo disponível e você receberá uma notificação.
O tempo médio para um saque ser concluído é de alguns minutos durante o horário comercial. Transferências PIX fora do horário podem ter delay maior dependendo do banco de destino.
