Base URL
Todas as requisições devem ser feitas para a seguinte URL base:
https://api.liquera.com.br
Versionamento
Todas as rotas estão prefixadas com /v1:
https://api.liquera.com.br/v1/charges
https://api.liquera.com.br/v1/merchants/me/withdrawals
Autenticação
A API aceita dois tipos de autenticação via header Authorization: Bearer:
- JWT — para uso no seu backend ou durante o desenvolvimento
- API Key (
lk_...) — recomendado para integrações server-side em produção
Veja a seção Autenticação para mais detalhes.
Todos os valores monetários são representados em centavos (inteiros), sem decimais.
| Valor real | Valor na API |
|---|
| R$ 1,00 | 100 |
| R$ 49,90 | 4990 |
| R$ 1.000,00 | 100000 |
Nunca envie valores com casas decimais. amount: 10.50 será rejeitado — use amount: 1050.
message:
{
"message": "Descrição do erro"
}
| Status | Significado |
|---|
200 | Sucesso |
201 | Recurso criado |
400 | Requisição inválida (parâmetros incorretos) |
401 | Não autenticado (token ausente ou inválido) |
403 | Sem permissão (conta inativa, KYC pendente) |
404 | Recurso não encontrado |
409 | Conflito (recurso duplicado) |
422 | Dados inválidos (CPF/CNPJ incorreto, etc.) |
500 | Erro interno do servidor |
Rate limiting
| Contexto | Limite |
|---|
| Global (por IP) | 100 req/min |
Rotas de auth (/v1/auth/*) | 10 req/min por IP |
| Criação de cobranças | 30 req/min por merchant |
429 Too Many Requests.
Idempotência
A rota de criação de cobranças suporta o header x-idempotency-key. Envie uma chave única por operação para evitar cobranças duplicadas em caso de timeout ou retry.
x-idempotency-key: pedido-abc-123
