Pular para o conteúdo principal

​
Bem-vindo à API FireBanking

A FireBanking oferece múltiplos métodos de pagamento para atender diferentes necessidades de negócio. Escolha o método ideal para seu caso e siga nosso guia específico de integração.

PIX

⚡ Instantâneo • 💰 Taxa baixa • 🕐 24/7Ideal para pagamentos rápidos e custo baixo

Cartão de Crédito

⚡ Instantâneo • 📅 Parcelamento • 🔄 RecorrenteIdeal para e-commerce e parcelamento

Boleto Bancário

🏦 Universal • 💰 Taxa fixa • 📄 ComprovanteIdeal para valores altos e B2B
Não sabe qual escolher? Acesse nossa comparação detalhada dos métodos de pagamento.

​
Configuração Inicial

​
1. Obtenha suas Credenciais

  1. Acesse o Dashboard FireBanking
  2. Vá em API & Webhooks → Chaves de API
  3. Copie sua chave de Sandbox (formato: a9b484fc-90a6-4255-9394-e3c1ca0633b9)
Exemplo de Chave
a9b484fc-90a6-4255-9394-e3c1ca0633b9

​
2. Ambientes Disponíveis

Sandbox (Testes)

Base URL: https://api-gateway.firebanking.devUse para desenvolvimento e testes

Produção

Base URL: https://api-gateway.firebanking.com.brUse apenas com dados reais validados

​
3. Estrutura da API

Nossa API é modular e organizada por método de pagamento:
  • PIX: {base_url}/pix/v2/payment
  • Cartão: {base_url}/credit-card/v1/payment
  • Boleto: {base_url}/bank-slip/v1/payment
  • Autenticação: Header x-api-key obrigatório
  • Formato JSON: Todas as requisições e respostas
  • Códigos HTTP: Semânticos (200, 400, 403, 500, etc.)
  • IDs únicos: Identificadores consistentes
  • Webhooks: Notificações em tempo real

​
Teste sua Conexão

Verifique se sua autenticação está funcionando: 
curl -X GET "https://api-gateway.firebanking.dev/v1/account/balance" \
  -H "x-api-key: "SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json"
Resposta esperada: 
{
  "id": "UM_ID_UNICO",
  "totalBalance": 0,
  "blockedBalance": 0,
  "availableBalance": 0
}

​
Guias de Integração por Método

Agora que você tem suas credenciais configuradas, escolha seu método preferido e siga o guia específico:

​
🚀 Recomendado para Iniciantes: PIX

Guia Completo PIX

Por que começar com PIX?
  • ✅ Integração mais simples
  • ✅ Menor custo (taxa fixa)
  • ✅ Confirmação instantânea
  • ✅ Funciona 24h/7 dias
Tempo estimado: 15-20 minutos

​
💳 Para E-commerce: Cartão de Crédito

Guia Completo Cartão

Ideal se você precisa de:
  • ✅ Parcelamento em até 12x
  • ✅ Assinaturas recorrentes
  • ✅ Tokenização de cartões
  • ✅ Pré-autorização
Tempo estimado: 25-30 minutos

​
🏦 Para Valores Altos: Boleto Bancário

Guia Completo Boleto

Ideal se você tem:
  • ✅ Clientes sem cartão
  • ✅ Valores acima de R$ 200
  • ✅ Necessidade de comprovante físico
  • ✅ Flexibilidade de prazo
Tempo estimado: 20-25 minutos

​
Recursos Adicionais

Comparação de Métodos

Entenda qual método escolher para cada cenário

Conceitos de Pagamentos

Aprenda sobre fluxos e conceitos fundamentais

Configurar Webhooks

Receba notificações em tempo real

Ambiente de Testes

Guia completo para testes e validação

​
Implementação Múltipla

Muitas empresas implementam vários métodos para maximizar a conversão:
1

Comece com PIX

Implementação mais rápida e menor custo
2

Adicione Cartão

Para parcelamento e assinaturas
3

Inclua Boleto

Para clientes sem cartão e valores altos
4

Configure Webhooks

Monitore todos os métodos em tempo real
🎯 Próximo Passo: Escolha um dos guias de integração acima e comece a processar pagamentos em menos de 20 minutos!
Dúvidas? Nossa documentação completa tem exemplos detalhados para todos os cenários.