Solicitar saque

Transfira o saldo disponível para uma chave PIX.

POST /v1/merchants/me/withdrawals

Solicita 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

amount · integer · required

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.

pixKeyType · string · required

Tipo da chave PIX de destino. Valores aceitos:

Valor	Descrição
CPF	Chave no formato CPF (11 dígitos)
CNPJ	Chave no formato CNPJ (14 dígitos)
EMAIL	Chave no formato email
PHONE	Chave no formato telefone ([phone])
CHAVE_ALEATORIA	Chave aleatória (EVP)

pixKey · string · required

Chave PIX de destino. O formato deve ser compatível com o pixKeyType informado.

description · string

Descrição opcional do saque. Máximo de 200 caracteres. Aparece nos registros internos.

Exemplos

Saque para CPF

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"
  }'

Saque para email

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": "[e-mail]"
  }'

Saque para chave aleatória

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

message · string

Confirmação da solicitação.

withdraw · object

Dados do saque criado.

Show campos

withdraw.id · string

ID único do saque no ledger. Use para rastrear o status.

withdraw.amount · integer

Valor do saque em centavos.

withdraw.description · string | null

Descrição informada, ou null.

withdraw.status · string

Status inicial: PROCESSING.

withdraw.batchId · string | null

ID do lote no adquirente, para rastreamento.

withdraw.createdAt · string

Data e hora de criação em ISO 8601.

balance · object

Saldo atualizado após a dedução do saque.

Show campos

balance.available · integer

Saldo disponível para saque em centavos.

balance.pending · integer

Saldo aguardando liquidação em centavos.

balance.blocked · integer

Saldo bloqueado em centavos.

balance.total · integer

Saldo total (available + pending + blocked) em centavos.

201 — Em processamento

{
  "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
  }
}

400 — Saldo insuficiente

{
  "message": "Saldo insuficiente para realizar o saque"
}

400 — KYC não aprovado

{
  "message": "KYC precisa estar aprovado para solicitar saque"
}

400 — Valor abaixo do mínimo

{
  "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.