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

# BukioPay | Documentação da API

> Plataforma de e-commerce brasileira com Pix integrado. Crie cobranças, gerencie pedidos e produtos, e receba a confirmação de pagamento por webhook.

A BukioPay é uma plataforma de e-commerce para o mercado brasileiro. Sua loja fica pronta para vender, com catálogo, checkout e pagamento por Pix integrados. Use esta API para conectar a loja ao seu sistema.

<CardGroup cols={2}>
  <Card title="Primeiros Passos" icon="rocket" href="/quickstart">
    Crie sua primeira cobrança Pix e receba a confirmação por webhook.
  </Card>

  <Card title="Visão Geral da API" icon="eye" href="/api-reference/overview">
    URL base, autenticação, valores em reais e formato das respostas.
  </Card>

  <Card title="Cobranças Pix" icon="qrcode" href="/api-reference/pix-charges/create">
    Gere QR Code e Copia e Cola para receber pagamentos instantâneos.
  </Card>

  <Card title="Webhooks" icon="bell" href="/api-reference/webhooks/eventos">
    Receba a confirmação de pagamento no seu servidor.
  </Card>
</CardGroup>

## Como funciona

Você cria uma cobrança, recebe o QR Code e o Copia e Cola, e o cliente paga pelo app do banco. A confirmação chega ao seu sistema por webhook.

<Steps>
  <Step title="Gere sua API Key">
    No painel da BukioPay, abra as configurações de API e gere uma chave. Use apenas no servidor.
  </Step>

  <Step title="Cadastre a URL do seu webhook">
    Informe a URL do seu servidor e marque o evento `payment.paid`. É por aí que você fica sabendo dos pagamentos.
  </Step>

  <Step title="Crie a cobrança">
    Envie `POST /api/v1/transactions` com o valor e os dados do cliente. A resposta traz o QR Code e o Copia e Cola.
  </Step>

  <Step title="Entregue depois da confirmação">
    Quando o webhook `payment.paid` chegar, libere o produto ao cliente.
  </Step>
</Steps>

## O que você pode fazer

<CardGroup cols={3}>
  <Card title="Cobranças Pix" icon="bolt">
    QR Code e Copia e Cola para receber pagamentos instantâneos.
  </Card>

  <Card title="Pedidos" icon="bag-shopping">
    Checkout público com cálculo de total no servidor e acompanhamento do ciclo de vida.
  </Card>

  <Card title="Produtos" icon="box">
    Catálogo com preço, variações e categorias.
  </Card>

  <Card title="Categorias" icon="tags">
    Organize o catálogo para facilitar a navegação do cliente.
  </Card>

  <Card title="Cupons" icon="ticket">
    Descontos percentuais ou de valor fixo, com limite de uso e validade.
  </Card>

  <Card title="Saques" icon="money-bill-transfer">
    Transfira o saldo da carteira para uma chave Pix.
  </Card>
</CardGroup>

<Note>
  Todos os valores monetários da API são em **reais com decimais**, não em centavos. `49.90` é R\$ 49,90.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.