Como faço minha primeira cobrança pela API?
São três passos. Do zero à primeira cobrança leva alguns minutos.
São três passos. Do zero à primeira cobrança leva alguns minutos.
1. Gere sua chave de API
No painel, vá em API Keys → Criar nova chave.
A chave aparece uma única vez — copie e guarde num lugar seguro. Se perder, gere outra.
Nunca coloque a chave no código do seu site (o que roda no navegador). Ela deve ficar só no seu servidor. Quem tem a chave consegue criar cobranças na sua conta.
2. Crie a cobrança
Envie a chave no cabeçalho X-Api-Key:
curl -X POST https://app.flowinpay.com.br/api/v1/charges \
-H "X-Api-Key: SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"value": 49.90,
"description": "Pedido 1234",
"customer": { "name": "Maria Silva", "email": "maria@exemplo.com" }
}'
A resposta traz o código Pix copia e cola e o QR Code para mostrar ao seu cliente.
3. Receba a confirmação do pagamento
Não fique consultando a API para saber se pagou. Configure um webhook: assim que o Pix cair, avisamos seu sistema automaticamente.
Configure em API Keys → Webhooks e confira o guia de webhook na documentação — lá está como validar a assinatura, que é o que garante que o aviso veio mesmo da FlowinPay.
Precisa de ajuda para integrar?
A documentação completa fica em /docs. Se algo não funcionar como esperado, abra um chamado na categoria Integração / API com o trecho de código e a resposta que recebeu.
Central de ajuda · FlowinPay
