Primeira Cobrança Pix na BukioPay

Em poucos minutos você cria sua primeira cobrança Pix e recebe a confirmação do pagamento no seu servidor.

Gere sua API Key

No painel da BukioPay, abra as configurações de API e gere uma chave. Ela começa com sk_live_ e aparece por completo uma única vez — guarde em variável de ambiente.

A API Key dá acesso total à sua conta. Use apenas no servidor, nunca em código que roda no navegador ou no aplicativo.

Cadastre a URL do seu webhook

Ainda nas configurações de API, informe a URL do seu servidor e marque o evento payment.paid. A confirmação do pagamento chega por webhook, não na resposta da criação da cobrança.

Crie a cobrança

Envie o valor em reais e os dados de quem vai pagar:

curl -X POST 'https://api.bukiopay.com/api/v1/transactions' \
  --header 'Authorization: Bearer sk_live_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "PIX_IN",
    "amount": 50,
    "description": "Primeira cobrança",
    "customer": {
      "name": "João Silva",
      "email": "joao@exemplo.com"
    }
  }'

Exiba o QR Code ao cliente

A resposta traz o id da cobrança, o QR Code em Base64 e o Copia e Cola:

{
  "success": true,
  "data": {
    "id": "e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2",
    "status": "PENDING",
    "amount": 50,
    "feeAmount": 2.49,
    "netAmount": 47.51,
    "payment": {
      "copyPaste": "00020126580014BR.GOV.BCB.PIX...",
      "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUg..."
    },
    "externalReference": "2IH180IE",
    "expiresAt": "2026-08-26T12:28:00.000Z"
  }
}

Guarde o id — é por ele que você reconhece a cobrança quando o webhook chegar.

Receba a confirmação

Quando o cliente pagar, seu servidor recebe:

{
  "event": "payment.paid",
  "data": {
    "id": "e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2",
    "status": "paid",
    "amount": 50,
    "paidAt": "2026-08-26T12:00:00.000Z"
  },
  "requestId": "req_0123456789abcdef"
}

Valide o header X-Webhook-Signature, responda 2xx em até 15 segundos e trate a entrega de forma idempotente usando o requestId.

Só libere o produto depois da confirmação do pagamento. Nunca entregue com base no que o navegador do cliente informa.

Valores em reais

Os valores da API são em reais com decimais, não em centavos. 50 é R$ 50,00 e 19.9 é R$ 19,90. O mínimo de uma cobrança é 1.00.

Repita com segurança

Se uma requisição falhar sem resposta clara, não crie outra cobrança às cegas: você pode cobrar o cliente duas vezes. Consulte a cobrança pelo id antes de repetir, ou use uma chave de idempotência quando o endpoint aceitar.

Próximos passos

Cobranças Pix

Todos os parâmetros, respostas e códigos de erro do endpoint de cobranças.

Webhooks

A lista completa de eventos e como validar a assinatura.

Pedidos

Venda produtos do catálogo com checkout público e cálculo de total no servidor.

Saques

Transfira o saldo da carteira para uma chave Pix.

Introdução

Conceitos

Primeira Cobrança Pix na BukioPay

Valores em reais

Repita com segurança

Próximos passos

Cobranças Pix

Webhooks

Pedidos

Saques

​Valores em reais

​Repita com segurança

​Próximos passos

Cobranças Pix

Webhooks

Pedidos

Saques

Valores em reais

Repita com segurança

Próximos passos