Solicitar saque

`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

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.

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 (`+5511999998888`)
`CHAVE_ALEATORIA`	Chave aleatória (EVP)

string

required

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

string

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

Exemplos

Saque para CPF
Saque para email
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": 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

string

Confirmação da solicitação.

object

Dados do saque criado.

Show campos

string

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

integer

Valor do saque em centavos.

string | null

Descrição informada, ou null.

string

Status inicial: PROCESSING.

string | null

ID do lote no adquirente, para rastreamento.

string

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

object

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

Show campos

integer

Saldo disponível para saque em centavos.

integer

Saldo aguardando liquidação em centavos.

integer

Saldo bloqueado em centavos.

integer

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

201 — Em processamento
400 — Saldo insuficiente
400 — KYC não aprovado
400 — Valor abaixo do mínimo

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

Cobranças

Saques

Solicitar saque

`POST /v1/merchants/me/withdrawals`

Pré-requisitos

Request

Body

Exemplos

Response

Ciclo de vida do saque

​POST /v1/merchants/me/withdrawals

​Pré-requisitos

​Request

​Body

​Exemplos

​Response

​Ciclo de vida do saque

`POST /v1/merchants/me/withdrawals`

Pré-requisitos

Request

Body

Exemplos

Response

Ciclo de vida do saque