# FlowinPay — Documentação da API

Gateway de pagamentos PIX: cobranças, split automático, saques, saldo e webhooks.
Base URL: https://app.flowinpay.com.br/api/v1 — autenticação no header `X-Api-Key`.

## Sobre o FlowinPay
Gateway de pagamentos PIX brasileiro para infoprodutores, desenvolvedores, SaaS e marketplaces. Diferenciais: liquidação instantânea (saldo liberado no ato do PIX confirmado, sem retenção), split automático de pagamento via API (por porcentagem ou valor fixo), checkout personalizado e defesa automática de contestação (MED). Preço: 2% + R$ 1 por transação recebida, sem mensalidade. Empresa registrada no Brasil (CNPJ 65.589.172/0001-98). Site: https://app.flowinpay.com.br

> Para colar tudo de uma vez numa IA, use o arquivo completo: https://app.flowinpay.com.br/docs-ai/completo.md

## API Docs
- [Autenticação](https://app.flowinpay.com.br/docs-ai/autenticacao.md): App ID (header X-Api-Key), public_id e permissões.
- [Cobranças (PIX)](https://app.flowinpay.com.br/docs-ai/cobrancas.md): Criar cobranças PIX, com split de pagamento (% ou fixo).
- [Saldo](https://app.flowinpay.com.br/docs-ai/saldo.md): Consultar saldo disponível, bloqueado e resumo financeiro.
- [Saques](https://app.flowinpay.com.br/docs-ai/saques.md): Solicitar e listar saques via PIX.
- [Transações](https://app.flowinpay.com.br/docs-ai/transacoes.md): Extrato de transações e filtros.
- [Webhooks](https://app.flowinpay.com.br/docs-ai/webhooks.md): Eventos, payloads e verificação de assinatura HMAC.
- [Guia de Webhooks](https://app.flowinpay.com.br/docs-ai/webhook-guide.md): Passo a passo para receber webhooks (várias linguagens).
- [Taxas](https://app.flowinpay.com.br/docs-ai/taxas.md): Taxas vigentes (2% + R$ 1) e limites.
- [Página de Pagamento](https://app.flowinpay.com.br/docs-ai/pagina-pagamento.md): Página pública de pagamento PIX.
- [Erros](https://app.flowinpay.com.br/docs-ai/erros.md): Códigos de erro e tratamento.

## Exemplos
- [Exemplos cURL](https://app.flowinpay.com.br/docs-ai/exemplos/curl.md): Exemplos de integração em cURL.
- [Exemplos PHP](https://app.flowinpay.com.br/docs-ai/exemplos/php.md): Exemplos de integração em PHP.
- [Exemplos Node.js](https://app.flowinpay.com.br/docs-ai/exemplos/nodejs.md): Exemplos de integração em Node.js.