Autenticação - Liquerapay

Use apenas o header Authorization: Bearer, seguido do valor da API key (liq_...) ou do JWT do painel. Outros formatos (por exemplo x-api-key) não são aceitos; token ausente ou inválido resulta em 401 UNAUTHORIZED.

A API Liquerapay autentica todas as requisições via header Authorization: Bearer, seguido da sua API key (liq_...) ou do JWT do painel. O mesmo header é usado tanto para API keys (integrações server-side) quanto para JWT (dashboard).

Como obter sua chave

Acesse app.liquerapay.com
Vá em Configurações → API Keys
Clique em Gerar chave
Copie a chave imediatamente — ela só é exibida uma vez, no formato completo

A chave concede acesso total à sua conta. Nunca comite ela em repositórios, exponha em frontend, ou envie por canais inseguros.

Como usar

Inclua o header em toda requisição:

curl https://api.liquerapay.com/transparents/list \
  -H "Authorization: Bearer liq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"

Exemplo em outras linguagens:

const res = await fetch('https://api.liquerapay.com/transparents/list', {
  headers: {
    Authorization: `Bearer ${process.env.LIQUERAPAY_API_KEY}`,
  },
})

import os, requests

res = requests.get(
    "https://api.liquerapay.com/transparents/list",
    headers={"Authorization": f"Bearer {os.environ['LIQUERAPAY_API_KEY']}"},
)

Boas práticas de segurança

Recomendações

Armazene a chave em variáveis de ambiente ou cofres (Vault, AWS Secrets Manager, etc.)
Rotacione as chaves periodicamente — gere uma nova, atualize sua aplicação, revogue a antiga
Revogue imediatamente se houver suspeita de vazamento
Use chaves separadas por serviço quando possível para isolar impacto
Monitore o uso pelos logs de auditoria no painel

Erros de autenticação

HTTP	`error`	Causa
`401`	`UNAUTHORIZED`	Header `Authorization` ausente ou mal formatado
`401`	`UNAUTHORIZED`	Token inválido ou revogado
`403`	`FORBIDDEN`	Token válido mas conta suspensa

Exemplo de resposta:

{
  "error": "UNAUTHORIZED",
  "message": "Token inválido ou ausente",
  "success": false
}

​Como obter sua chave

​Como usar

​Boas práticas de segurança

Recomendações

​Erros de autenticação

Como obter sua chave

Como usar

Boas práticas de segurança

Erros de autenticação