Listar saques

`GET /v1/merchants/me/withdrawals`

Retorna os saques do merchant autenticado, ordenados do mais recente para o mais antigo, com paginação.

Request

GET https://api.liquera.com.br/v1/merchants/me/withdrawals
Authorization: Bearer <jwt_ou_api_key>

Query parameters

integer

Número da página. Começa em 1. Padrão: 1.

integer

Número de saques por página. Mínimo: 1. Máximo: 100. Padrão: 20.

Exemplos

# Todos os saques
curl "https://api.liquera.com.br/v1/merchants/me/withdrawals" \
  -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Página 2 com 10 por página
curl "https://api.liquera.com.br/v1/merchants/me/withdrawals?page=2&limit=10" \
  -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

integer

Página atual.

integer

Limite por página.

integer

Total de saques registrados.

array

Lista de saques.

Show campos de cada saque

string

ID único do saque no ledger.

integer

Valor do saque em centavos.

string | null

Descrição do saque, ou null.

string

Status do saque:

Status	Descrição
`PROCESSING`	Transferência enviada ao adquirente, aguardando confirmação
`COMPLETED`	Transferência PIX concluída com sucesso
`FAILED`	Transferência rejeitada — saldo revertido automaticamente

string | null

ID do lote no adquirente.

string | null

Chave PIX de destino utilizada.

string | null

Tipo da chave PIX: CPF, CNPJ, EMAIL, PHONE ou CHAVE_ALEATORIA.

string

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

200 — Sucesso
404 — Merchant não encontrado

{
  "page": 1,
  "limit": 20,
  "total": 3,
  "withdrawals": [
    {
      "id": "clx5mno345",
      "amount": 50000,
      "description": "Retirada quinzenal",
      "status": "COMPLETED",
      "batchId": "batch_abc123",
      "pixKey": "12345678901",
      "pixKeyType": "CPF",
      "createdAt": "2025-01-15T15:00:00.000Z"
    },
    {
      "id": "clx6pqr678",
      "amount": 150000,
      "description": null,
      "status": "PROCESSING",
      "batchId": "batch_def456",
      "pixKey": "financeiro@empresa.com.br",
      "pixKeyType": "EMAIL",
      "createdAt": "2025-01-14T09:00:00.000Z"
    },
    {
      "id": "clx7stu901",
      "amount": 25000,
      "description": "Teste",
      "status": "FAILED",
      "batchId": null,
      "pixKey": "99999999999",
      "pixKeyType": "CPF",
      "createdAt": "2025-01-10T12:00:00.000Z"
    }
  ]
}

{
  "message": "Merchant não encontrado"
}

Cobranças

Saques

`GET /v1/merchants/me/withdrawals`

Request

Query parameters

Exemplos

Response

​GET /v1/merchants/me/withdrawals

​Request

​Query parameters

​Exemplos

​Response

`GET /v1/merchants/me/withdrawals`

Request

Query parameters

Exemplos

Response