Pré-requisitos
- Uma conta ativa na Flare Payments
- Sua API Key (disponível no Dashboard em Configurações → API Keys)
Passo 1 — Criar uma Cobrança PIX
Faça um POST /v1/charges com o valor em centavos:
curl -X POST https://api.flarepayments.com/v1/charges \
-H "Authorization: Bearer flare_sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{
"amount": 1000,
"description": "Pedido #1234",
"customer": {
"name": "João Silva",
"email": "joao@email.com",
"document": "12345678900"
}
}'
O campo amount é sempre em centavos. Para cobrar R$ 10,00, envie 1000.
{
"id": "ch_flare_dc7dc11b7f984d2886d2b429",
"object": "charge",
"amount": 10.00,
"amount_cents": 1000,
"status": "pending",
"pix": {
"qr_code": "base64...",
"copy_paste": "00020101021226...",
"payment_link": "https://..."
},
"expires_at": "2026-03-05T19:14:48.549Z",
"created_at": "2026-03-05T18:14:48.552Z"
}
Passo 2 — Exibir o QR Code para o cliente
Use o campo pix.copy_paste para exibir o código PIX copia-e-cola, ou pix.qr_code (base64) para renderizar o QR Code visualmente.
// Renderizar QR Code
const img = document.createElement('img');
img.src = `data:image/png;base64,${charge.pix.qr_code}`;
document.body.appendChild(img);
// Ou mostrar o código copia-e-cola
console.log(charge.pix.copy_paste);
Passo 3 — Verificar o Status
Consulte o status da cobrança via polling ou configure um Webhook:
curl https://api.flarepayments.com/v1/charges/ch_flare_dc7dc11b7f984d2886d2b429/status \
-H "Authorization: Bearer flare_sua_chave_aqui"
{
"id": "ch_flare_dc7dc11b7f984d2886d2b429",
"status": "paid",
"is_paid": true,
"paid_at": "2026-03-05T18:16:22.000Z"
}
Próximos Passos
