> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquerapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  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**.
</Note>

## Fluxo completo

<Steps>
  <Step title="Criar a cobrança">
    `POST /transparents/create` com `amount` (centavos) e `method: "PIX"`.
    A resposta já vem com `brCode` e `imageBase64`.
  </Step>

  <Step title="Apresentar o QR Code">
    Renderize `imageBase64` como `<img>` ou ofereça `brCode` num botão
    "copiar código".
  </Step>

  <Step title="Aguardar o pagamento">
    Prefira um [webhook](/pages/webhooks/reference) (`CHARGE_PAID`) a fazer
    polling. Se precisar consultar sob demanda, use
    `GET /transparents/check?id=...`.
  </Step>

  <Step title="Devolver, se necessário">
    `POST /transparents/refund?id=...` — devolução sempre integral, sem body.
  </Step>
</Steps>

## Exemplo de ponta a ponta

<CodeGroup>
  ```bash cURL — criar theme={null}
  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
    }'
  ```

  ```bash cURL — consultar theme={null}
  curl "https://api.liquerapay.com/transparents/check?id=chg_018f8e2d9a5f7b10c3d4" \
    -H "Authorization: Bearer $LIQUERAPAY_API_KEY"
  ```

  ```bash cURL — devolver theme={null}
  curl -X POST "https://api.liquerapay.com/transparents/refund?id=chg_018f8e2d9a5f7b10c3d4" \
    -H "Authorization: Bearer $LIQUERAPAY_API_KEY"
  ```
</CodeGroup>

## 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.

<CardGroup cols={2}>
  <Card title="Referência completa" icon="book" href="/pages/transparents/reference">
    Todos os campos, status e endpoints do Checkout Transparente.
  </Card>

  <Card title="Configurar webhooks" icon="webhook" href="/pages/webhooks/reference">
    Receba `CHARGE_PAID`, `REFUND_COMPLETED` e outros eventos em tempo real.
  </Card>
</CardGroup>