Skip to main content

​
Recursos

A sua conta/loja dentro da Liquerapay. Toda chave de API e todo recurso (cobranças, clientes, saques) pertence a um merchant.
Um cliente final que paga você. Cadastrar customers é opcional, mas facilita identificação e relatórios. Identificado por CPF/CNPJ único por merchant.
Uma cobrança PIX: gera um QR Code (texto copia-e-cola + imagem base64) para o cliente pagar. Tem ciclo de vida: PENDING → PAID/EXPIRED, e uma cobrança PAID pode virar REFUNDED ou DISPUTED.
Uma devolução integral de uma cobrança paga (não há devolução parcial). Debita do saldo do merchant — a taxa cobrada na cobrança original não é devolvida.
Um saque do saldo do merchant para uma chave PIX. Paga uma taxa adicional debitada do saldo.
Uma URL HTTPS cadastrada para receber eventos. Você escolhe quais eventos (events) ele recebe, e cada endpoint tem um secret — a chave de assinatura usada para validar a autenticidade das requisições.

​
Conceitos

Todos os valores monetários são em centavos (inteiros). Uma cobrança de R$ 50,00 é representada como 5000. Nunca use float.
  • available: pronto para saque
  • pending: aguardando confirmação (D+0 normalmente)
  • blocked: bloqueado por disputas/infrações
Valor descontado da cobrança ou debitado do saldo no saque. O valor exato depende do contrato do merchant.
Identificador único do PIX no sistema do Banco Central. Necessário para solicitar devoluções.
Paginação bidirecional via after/before (cursores opacos retornados em pagination). Mais consistente que offset em listas que mudam com frequência.
Assinatura no header Liquera-Signature (formato t=<timestamp>,v1=<hmac>), calculada com HMAC-SHA256 sobre "${timestamp}.${corpo bruto}" usando o secret do webhook. Permite verificar que a requisição realmente veio da Liquerapay — veja o guia de webhooks.

​
Status de cobranças

​
Status de saques

​
Tipos de chave PIX