Visão geral da Fire Banking

A Fire Banking é uma techfin B2B que entrega infraestrutura de meios de pagamento por meio de APIs. Começamos como uma API de PIX e hoje oferecemos, de forma modular, integração com PIX, Boleto e Cartão de Crédito. Nossa plataforma foi desenhada para que o cliente se conecte uma única vez e consuma os serviços que precisa, sem precisar lidar diretamente com múltiplos provedores bancários. Essa abstração reduz complexidade operacional e acelera o time-to-market dos nossos clientes.

Estrutura e escopo da API

A API pública da Fire Banking é exposta a partir do domínio base:

Os produtos são modularizados em caminhos dedicados para refletir essa separação funcional:

Serviço	URL
PIX	https://api-gateway.firebanking.com.br/pix
Boleto	https://api-gateway.firebanking.com.br/bank-slip
Cartão de crédito	https://api-gateway.firebanking.com.br/credit-card

Cada uma dessas verticais encapsula o conjunto de operações relacionadas ao respectivo meio de pagamento. Em breve haverá também um nível de orquestração — internamente referenciado como módulo de cobranças — que permite tratar cobranças e reconciliações de forma uniforme, independentemente do canal efetivo de liquidação.

A API segue convenções consistentes de formatação (tipicamente JSON), uso semântico de códigos HTTP e identificação de recursos, de modo a facilitar integração, tratamento de erros e automação por parte dos clientes.

Diferencial técnico: hub de provedores

Por trás de uma interface e um contrato de API únicos, o cliente não precisa se preocupar com a escolha do provedor. Ele se conecta à Fire via API e, por meio dessa camada de abstração, pode rotear transações para os bancos já integrados conosco. Essa arquitetura transforma a Fire em um hub de pagamentos com troca de fornecedor transparente ao cliente, sem que ele precise alterar sua integração quando ocorrem mudanças de backend, failover ou balanceamento entre provedores.

Autenticação

Todas as requisições à API exigem autenticação, que serve para identificação do cliente, roteamento, permissões e auditoria. Os métodos de autenticação atualmente suportados são:

• Chave de API / API Key: emitida via portal da Fire Banking ou por contato com um representante. Deve ser enviada no cabeçalho das requisições conforme especificado na seção de autenticação (ex.: em um cabeçalho Authorization do tipo Bearer). Cada chave está associada a um contexto de cliente e a escopos definidos.

Se a autenticação estiver ausente, incorreta ou inválida, a API retornará um erro 403 Forbidden, com mensagem indicando que o recurso é proibido devido à falta de credenciais válidas.

Principais características (visão resumida)

• Formato de payloads e respostas: JSON.

• Uso semântico de códigos HTTP: 2xx para sucesso, 4xx para erro do cliente, 5xx para erro de servidor.

• Identificadores de recurso seguem padrões consistentes (por exemplo, UUIDs ou identificadores estruturados, conforme definido nos contratos de cada produto).

• Webhooks (quando aplicáveis) são assinados e devem ser validados pelo cliente para garantir integridade.

• Erros vêm com corpo estruturado para permitir tratamento programático.

Suporte

Caso tenha dúvidas, sugestões ou enfrente algum problema, não hesite em entrar em contato conosco. Fale com o seu gerente de conta.

Estamos à disposição para ajudar e tornar o processo de integração o mais simples possível.