Checkout Transparente

Crie cobranças PIX direto pela API e controle 100% da experiência de pagamento.

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

1. Criar a cobrança

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

2. Apresentar o QR Code

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

3. Aguardar o pagamento

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

4. Devolver, se necessário

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

Exemplo de ponta a ponta

cURL — criar

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
  }'

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.