Skip to main content

​
Como funciona

A BukioPay cuida da sua loja de ponta a ponta: vitrine, catálogo, carrinho, checkout, cobrança e entrega. Você vende sem montar infraestrutura de pagamento, e usa esta API para conectar a loja ao seu sistema — cadastrar produtos, criar pedidos, receber pagamentos e sacar o dinheiro. Principais características:
  • Liquidação instantânea: os pagamentos Pix são confirmados em segundos e caem na carteira da loja.
  • QR Code dinâmico: cada cobrança gera um QR Code único, pronto para exibir ao cliente.
  • Copia e Cola: além do QR Code, a API retorna o código Pix em texto para pagamentos manuais.
  • API REST: todas as operações usam JSON sobre HTTPS, com semântica clara de verbos HTTP (GET, POST, PATCH, DELETE).

​
Recursos disponíveis

A BukioPay cobre os principais fluxos de um negócio digital. Explore cada módulo abaixo:

Cobranças Pix

Crie cobranças Pix com QR Code e Copia e Cola, e acompanhe a confirmação do pagamento.

Pedidos

Visualize e gerencie os pedidos da sua loja, com rastreamento completo do ciclo de vida de cada venda.

Produtos

Cadastre, atualize e liste os produtos disponíveis no seu catálogo.

Categorias

Organize seus produtos em categorias para facilitar a navegação e a gestão do catálogo.

Cupons

Crie e aplique cupons de desconto para suas campanhas promocionais.

Loja

Consulte e atualize as informações e configurações da sua loja.

​
URL Base

Todas as requisições à API devem ser enviadas para a seguinte URL base:
Os endpoints são construídos a partir desta URL. Por exemplo, para listar pedidos, a URL completa seria:

​
Formato das respostas

A BukioPay retorna todas as respostas no formato JSON. Abaixo estão as convenções adotadas:
  • Valores monetários: sempre em reais, com decimais. Exemplo: 49.90 representa R$ 49,90.
  • Datas e horários: padrão ISO 8601, em UTC. Exemplo: 2026-05-22T14:30:00.000Z.
  • Estrutura de erro: respostas de erro incluem um campo message com a descrição do problema.

​
Status dos recursos

Os recursos da API usam códigos de status textuais para indicar o estado atual de cada registro. Cobranças Pix Pedidos
Nunca exponha sua API Key em código frontend (JavaScript no navegador, aplicativos móveis, etc.). Ela deve ser usada exclusivamente em ambientes de servidor. Qualquer pessoa que obtiver sua chave terá acesso completo à sua conta.
Pronto para começar? Siga o Quickstart e faça sua primeira cobrança Pix em minutos.