Checkout Transparente

O Checkout Transparente é o jeito de integrar PIX chamando a API diretamente: você envia o valor, recebe um QR Code (texto copia-e-cola e imagem base64) e decide exatamente como e onde exibi-lo — no seu app, no seu site, num terminal, onde fizer sentido para o seu produto.

A Liquerapay também tem o Checkout Hospedado (carrinho de produtos + página de pagamento hospedada, incluindo links de pagamento reutilizáveis). Se você prefere redirecionar o cliente para uma página pronta em vez de construir sua própria UI, esse é o caminho — documentação chega em breve. Use o Checkout Transparente quando quiser controle total da UI.

Fluxo completo

Criar a cobrança

POST /transparents/create com amount (centavos) e method: "PIX". A resposta já vem com brCode e imageBase64.

Apresentar o QR Code

Renderize imageBase64 como <img> ou ofereça brCode num botão “copiar código”.

Aguardar o pagamento

Prefira um webhook (CHARGE_PAID) a fazer polling. Se precisar consultar sob demanda, use GET /transparents/check?id=....

Devolver, se necessário

POST /transparents/refund?id=... — devolução sempre integral, sem body.

Exemplo de ponta a ponta

curl -X POST https://api.liquerapay.com/transparents/create \
  -H "Authorization: Bearer $LIQUERAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "PIX",
    "amount": 5000,
    "description": "Pedido #1234",
    "expiresIn": 1800
  }'

curl "https://api.liquerapay.com/transparents/check?id=chg_018f8e2d9a5f7b10c3d4" \
  -H "Authorization: Bearer $LIQUERAPAY_API_KEY"

curl -X POST "https://api.liquerapay.com/transparents/refund?id=chg_018f8e2d9a5f7b10c3d4" \
  -H "Authorization: Bearer $LIQUERAPAY_API_KEY"

Pré-requisitos da conta

Para criar cobranças, seu merchant precisa:

Ter cobranças habilitadas (chargesEnabled)
Ter uma chave PIX ativa cadastrada

Sem isso, POST /transparents/create retorna 400 BAD_REQUEST. Confirme o status da sua conta com o time da Liquerapay se receber esse erro inesperadamente.

Referência completa

Todos os campos, status e endpoints do Checkout Transparente.

Configurar webhooks

Receba CHARGE_PAID, REFUND_COMPLETED e outros eventos em tempo real.

​Fluxo completo

​Exemplo de ponta a ponta

​Pré-requisitos da conta

Referência completa

Configurar webhooks

Fluxo completo

Exemplo de ponta a ponta

Pré-requisitos da conta