Solicitar saque
Saques
Solicitar Saque
Solicita um saque do seu saldo disponível para uma chave PIX.
Atenção:
- O valor mínimo é de 50 centavos (R 1.000.000,00)
- O saque inclui uma taxa que é debitada junto: o débito total é
amount + fee - Só é permitido um saque em andamento por vez (
PENDING/PROCESSING) — uma nova solicitação enquanto houver um em curso retorna400 - Saques podem estar bloqueados se
withdrawalsEnabledestiver desativado para o merchant
POST
Solicitar saque
Solicita um saque do saldo
Exemplo:
Resposta:
available para uma chave PIX.
Obrigatório
amount (mínimo 50 centavos), pixKey e pixKeyType. A taxa é calculada
automaticamente conforme o contrato do merchant.A resposta é enxuta — não devolve
pixKey/pixKeyType (você já os
enviou). Para ver todos os detalhes depois, use
GET /withdrawals/{id}.Só um saque por vez
Você só pode ter um saque em andamento (PENDING ou PROCESSING) por
merchant. Uma nova solicitação enquanto houver um em curso retorna 400 —
aguarde a conclusão (ou falha) do saque atual antes de solicitar outro.
Erros possíveis
O saque retorna imediatamente com status
PENDING. O processamento
real é assíncrono — acompanhe o resultado via GET /withdrawals/{id}
ou pelos webhooks WITHDRAWAL_COMPLETED / WITHDRAWAL_FAILED.Authorizations
Autentique suas requisições enviando o token no header
Authorization: Bearer <token>.
O token pode ser:
- Uma API key com prefixo
liq_, gerada em Dashboard Liquerapay → Configurações → API Keys. - Um JWT retornado pelo login do dashboard (uso interno).
Não há distinção de ambiente — toda chave vale para o único ambiente disponível (produção).
Body
application/json
Valor do saque em centavos (mínimo 50 = R$ 0,50, máximo 100.000.000 = R$ 1.000.000,00).
Required range:
50 <= x <= 100000000Example:
5000
Chave PIX que receberá o saque.
Required string length:
1 - 140Example:
"pagamentos@minhaloja.com"
Tipo da chave PIX:
CPF: CPF (apenas dígitos)CNPJ: CNPJ (apenas dígitos)EMAIL: e-mail válidoTELEFONE: celular no formato+5511999999999CHAVE_ALEATORIA: chave aleatória (UUID/EVP)
Available options:
CPF, CNPJ, EMAIL, TELEFONE, CHAVE_ALEATORIA Example:
"EMAIL"
Texto livre para sua referência.
Maximum string length:
140Example:
"Repasse semanal"
CPF/CNPJ do destinatário da chave PIX (opcional).
Maximum string length:
18Example:
"12345678900"
Response
Saque criado e enfileirado para processamento.