Documentação

Base de produção: https://api.livrepix.com. Envie sua chave no cabeçalho Authorization: Bearer lp_live_.... Nunca coloque a chave no navegador ou em repositórios.

Credenciais no painel

Entre no painel pelo link enviado ao seu e-mail para criar e revogar chaves, definir a URL padrão do webhook, copiar o segredo de assinatura ou rotacioná-lo. Uma chave nova é exibida por completo somente uma vez; depois, o painel mostra apenas o prefixo.

A URL padrão passa a valer para as novas cobranças que não enviarem webhook_url no corpo. Ao rotacionar o segredo, atualize seu sistema imediatamente: as próximas assinaturas usam o novo valor.

Criar cobrança

POST /api/v1/charges
Authorization: Bearer $LIVREPIX_KEY
Idempotency-Key: pedido_4821
Content-Type: application/json

{
  "amount_cents": 2500,
  "payer_cpf": "CPF_OU_CNPJ_VALIDO",
  "payer_name": "Cliente",
  "description": "Créditos",
  "external_id": "pedido_4821",
  "webhook_url": "https://seuapp.com/webhooks/livrepix"
}

amount_cents fica entre 1000 e 600000. Também é aceito amount como decimal. O CPF/CNPJ é obrigatório e fica armazenado somente como hash irreversível mais os quatro últimos dígitos.

Link e checkout incorporado

A resposta da criação inclui checkout_url. Envie essa URL ao cliente como link de pagamento ou incorpore o checkout no seu site. A área de pagamento é pública; sua chave de API nunca vai para o navegador.

<iframe
  src="https://livrepix.com/c/?id=lp_ch_..."
  title="Pagamento Pix"
  width="480"
  height="720"
  style="width:100%;max-width:480px;border:0;border-radius:16px"
  allow="clipboard-write">
</iframe>

O checkout pode ser incorporado por páginas HTTPS. Para testar em desenvolvimento, localhost e 127.0.0.1 também são aceitos.

Consultar

Taxas, liquidação e saque

O ledger credita exatamente o valor líquido confirmado pelo processador de pagamento. A tabela atual é: 2% por pagamento confirmado; mais R$ 1,00 para cobranças de R$ 10,00 a R$ 50,00, inclusive; e R$ 0,50 pela liquidação D+1 na rede Liquid. Não há margem adicional livrepix nessas taxas. O acesso à plataforma é uma assinatura separada: os primeiros 30 dias não têm custo de assinatura; depois, o ciclo mensal custa R$ 29,90, com descontos nos ciclos de 3, 6 e 12 meses.

D+1 significa liquidação no dia seguinte, inclusive em fins de semana e feriados. O valor é convertido em DEPIX, pareado 1:1 com o real. As rotas de saque por USDT, BTC, DEPIX ou Pix ficam disponíveis no painel. A solicitação exige login por e-mail, reserva o saldo imediatamente e é processada em D+1. A cotação, o valor líquido e a referência final ficam registrados no histórico.

Webhooks livrepix

Eventos enviados: charge.completed, charge.expired, charge.refunded e withdrawal.paid. O endpoint recebe X-Webhook-Timestamp e X-Webhook-Signature. A assinatura hexadecimal é HMAC-SHA256 de timestamp + "." + corpo_bruto.

// Node.js
const expected = crypto
  .createHmac('sha256', process.env.LIVREPIX_WEBHOOK_SECRET)
  .update(timestamp + '.' + rawBody)
  .digest('hex');

if (!crypto.timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(signature, 'hex'))) {
  throw new Error('assinatura inválida');
}

Responda HTTP 2xx em até 8 segundos. Entregas malsucedidas são repetidas com backoff exponencial. Trate também o seu processamento como idempotente usando o ID da cobrança.

Estados

creating → pending → completed. Uma cobrança pendente também pode virar expired; uma concluída pode virar refunded. O saldo só muda com eventos autenticados.