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
Número da página. Começa em 1. Padrão: 1.
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
Total de saques registrados.
Lista de saques.Show campos de cada saque
ID único do saque no ledger.
Valor do saque em centavos.
Descrição do saque, ou null.
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 |
ID do lote no adquirente.
Chave PIX de destino utilizada.
Tipo da chave PIX: CPF, CNPJ, EMAIL, PHONE ou CHAVE_ALEATORIA.
Data e hora de solicitação em ISO 8601.
{
"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"
}
