Skip to main content
Este guia mostra o caminho mais rápido para criar sua primeira cobrança PIX usando a API Liquera.
Antes de começar, você precisa ter uma conta criada e aprovada pelo compliance (KYC aprovado). Se ainda não passou pelo processo de ativação, acesse o Dashboard para enviar sua documentação.

​
Passo 1 — Faça login e obtenha o JWT

Use suas credenciais para obter um token JWT. Você vai precisar dele para criar sua primeira API Key. 
curl -X POST https://api.liquera.com.br/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "voce@exemplo.com.br",
    "password": "sua_senha"
  }'
Resposta: 
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "clx1abc...",
    "email": "voce@exemplo.com.br",
    "role": "USER"
  }
}
Guarde o valor de token — você vai usar no próximo passo.

​
Passo 2 — Crie uma API Key

API Keys são a forma recomendada de autenticar integrações server-side. Diferente do JWT, elas não expiram e podem ser revogadas individualmente. 
curl -X POST https://api.liquera.com.br/v1/api-keys \
  -H "Authorization: Bearer SEU_JWT_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Produção",
    "description": "API Key principal do sistema"
  }'
Resposta: 
{
  "apiKey": {
    "id": "clx2def...",
    "name": "Produção",
    "description": "API Key principal do sistema",
    "value": "lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "ACTIVE",
    "createdAt": "2025-01-01T00:00:00.000Z"
  }
}
O campo value com o prefixo lk_ é exibido apenas uma vez. Salve-o imediatamente em um lugar seguro (variável de ambiente, secrets manager, etc). Não é possível recuperá-lo depois.

​
Passo 3 — Crie uma cobrança PIX

Agora use sua API Key para criar uma cobrança. O campo amount é em centavos. 
curl -X POST https://api.liquera.com.br/v1/charges \
  -H "Authorization: Bearer lk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 9990,
    "description": "Pedido #1234",
    "expiresIn": 3600
  }'
Resposta: 
{
  "charge": {
    "id": "clx3ghi...",
    "txid": "a1b2c3d4e5f6...",
    "qrCode": "00020126580014br.gov.bcb.pix...",
    "imageBase64": "data:image/png;base64,iVBORw0KGgo...",
    "amount": 9990,
    "status": "PENDING",
    "expiresIn": 3600,
    "customer": null
  }
}

​
Passo 4 — Exiba o QR Code para o pagador

Você tem duas opções para mostrar o QR Code:
Use o campo imageBase64 diretamente em uma tag <img>:
<img src="data:image/png;base64,iVBORw0KGgo..." alt="QR Code PIX" />
Quando o pagamento for confirmado, o status da cobrança muda de PENDING para PAID via webhook.

​
Próximos passos

Autenticação

Entenda a diferença entre JWT e API Key e quando usar cada um.

Cobranças

Referência completa da rota de criação de cobranças, com todos os campos opcionais.

Saques

Como solicitar saques do saldo disponível para uma chave PIX.

Idempotência

Evite cobranças duplicadas usando o header x-idempotency-key.