Como integrar PIX no seu site em 2026: guia técnico completo

Integrar PIX no seu site é a 1ª coisa que todo dev brasileiro faz em 2026. Aqui o guia passo a passo com código real usando a API do BravoPay.

Passo 1: criar conta + pegar API key

Cria conta em bravopay.club/signup, entra em Dashboard → API → Nova chave. Você recebe bp_live_XXX. Guarda em .env.

Passo 2: gerar PIX

POST https://bravopay.club/api/v1/transactions
Authorization: Bearer bp_live_XXX
Content-Type: application/json

{
  "amount_cents": 29700,
  "method": "pix",
  "customer": {
    "name": "João Silva",
    "email": "joao@exemplo.com",
    "cpf": "12345678909"
  },
  "product_id": "prod_ABC",
  "postback_url": "https://seusite.com/webhook/pix"
}

Retorno:

{
  "id": "tx_xyz",
  "status": "PENDING",
  "pix_qr_code": "00020126...",
  "pix_copy_paste": "00020126...",
  "expires_at": "2026-07-14T15:30:00Z"
}

Passo 3: mostrar QR code

No seu frontend, gera imagem do pix_qr_code com biblioteca JS tipo qrcode. Mostra também o botão "Copiar código PIX" que copia o pix_copy_paste.

Passo 4: receber webhook de confirmação

Quando o cliente paga, a gente POSTa em postback_url:

{
  "id": "tx_xyz",
  "status": "PAID",
  "paid_at": "2026-07-14T15:15:00Z",
  "amount_cents": 29700
}

Header X-Signature tem HMAC-SHA256 pra validar autenticidade. Compare constant-time com o secret que você gera no dashboard.

Passo 5: liberar produto

Quando o webhook chegar com status=PAID, você libera o produto (envia email, dá acesso à área de membros, dispara webhook interno). Idempotência é sua responsabilidade — a gente pode reenviar o webhook.

Erros comuns

• Não validar HMAC — permite alguém forjar "venda paga". SEMPRE valide.
• Não tratar idempotência — mesmo webhook chega 2x, você libera produto 2x.
• Confiar em polling ao invés de webhook — sobrecarrega a API e você paga em latência.
• Não expirar PIX pendente — polui seu dashboard.

Pronto — em 30min você tem PIX rodando. Explora docs.bravopay.club pra tudo (cartão, split, recorrência).