Pular para o conteúdo principal

​
API PIX FireBanking

A FireBanking oferece uma API completa de PIX que permite às empresas receber pagamentos instantâneos, realizar transferências e processar transações PIX de forma segura e em escala. O PIX é o sistema de pagamentos instantâneos brasileiro que funciona 24 horas por dia, 7 dias por semana, incluindo finais de semana e feriados.

PIX Cobrança

Receba pagamentos via QR Code ou chave PIX

PIX Transferência

Realize transferências para terceiros

Split PIX

Divida pagamentos entre múltiplos beneficiários

Webhooks

Receba notificações de transação em tempo real

​
Características Principais

​
Pagamentos Instantâneos

  • Confirmação em segundos: Transações processadas e confirmadas em até 10 segundos
  • Disponibilidade 24/7: Funciona todos os dias, incluindo finais de semana e feriados
  • Liquidação imediata: Valores disponíveis instantaneamente após confirmação

​
Flexibilidade de Integração

  • QR Code Dinâmico: Gere QR Codes únicos para cada transação
  • Chaves PIX: Aceite pagamentos via CPF, CNPJ, email, telefone ou chave aleatória
  • APIs v1 e v2: Suporte a versões antigas e modernas da API

​
Custos Reduzidos

  • Taxas baixas: Custos significativamente menores comparado ao cartão de crédito
  • Sem tarifa para pessoa física: Ideal para pequenos negócios e startups
  • Transparência total: Sem custos ocultos ou taxas surpresa

​
Tipos de Operação

​
PIX Cobrança (Cash In)

Receba pagamentos de clientes através de:
  • QR Code único para cada transação
  • Valor e dados do beneficiário pré-definidos
  • Ideal para e-commerce e checkout
  • Expiração configurável
  • Cliente insere sua chave PIX
  • Valor solicitado via notificação
  • Processo simplificado
  • Menor fricção para o pagador

​
PIX Saque (Cash Out)

Realize transferências para:
  • CPF, CNPJ, email, telefone
  • Chave aleatória (EVP)
  • Validação automática de dados
  • Transferência direta
  • Banco, agência, conta
  • Validação de titularidade
  • Suporte a conta corrente e poupança
  • Transferência tradicional via PIX
  • Leitura de QR Code do beneficiário
  • Validação automática dos dados
  • Transferência via câmera/upload
  • Processo visual e intuitivo

​
Fluxo de Integração

​
Recebimento (Cash In)

​
Transferência (Cash Out)

​
Segurança e Compliance

​
Validações Automáticas

  • Validação de chaves PIX em tempo real
  • Verificação de titularidade automática
  • Detecção de fraude integrada
  • Limites configuráveis por transação

​
Conformidade Regulatória

  • Banco Central do Brasil: Totalmente aderente às normas do BCB
  • Lei Geral de Proteção de Dados (LGPD): Dados protegidos e criptografados
  • Certificação PCI DSS: Segurança bancária para dados sensíveis
  • Auditoria contínua: Monitoramento 24/7 de transações

​
Ambientes Disponíveis

Sandbox

Base URL: https://api-gateway.firebanking.dev/v2
Ambiente de testes com PIX simulado

Produção

Base URL: https://api-gateway.firebanking.com.br/v2
PIX real integrado ao SPI (Sistema de Pagamentos Instantâneos)

​
Limitações e Considerações

​
Limites Operacionais

  • Valor máximo por transação: R$ 20.000,00 (noturno: R$ 1.000,00)
  • Limite mensal: Configurável por conta
  • Período noturno: 20h às 6h com limites reduzidos
  • Validação de beneficiário: Obrigatória para valores acima de R$ 200,00

​
Horários Especiais

  • Funcionamento 24/7: Incluindo feriados nacionais
  • Manutenção programada: Geralmente das 2h às 3h (eventual)
  • Limite noturno: Valores reduzidos entre 20h e 6h
  • Feriados: Funcionamento normal sem restrições

​
Início Rápido

​
1. Obtenha suas Chaves de API

Obtenha suas credenciais de API no painel FireBanking:
  • Chave de API: Para operações padrão de PIX
  • Credenciais de Webhook: Para receber notificações de transação
  • Token Interno: Para integrações sistema-a-sistema (se aplicável)

​
2. Faça sua Primeira Cobrança PIX

Primeira Cobrança PIX
curl -X POST "https://api-gateway.firebanking.com.br/pix/v2/payment" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction": {
      "value": 100.00,
      "description": "Primeira cobrança PIX",
      "externalId": "pedido-001"
    },
    "payer": {
      "fullName": "João da Silva",
      "document": "12345678901"
    }
  }'

​
Recursos Avançados

​
Split de Pagamento

  • Divisão automática: Repasse valores para múltiplos beneficiários
  • Regras flexíveis: Percentual ou valor fixo
  • Comissões configuráveis: Para marketplaces e plataformas
  • Repasse instantâneo: Valores disponíveis imediatamente

​
Conciliação Automática

  • Identificação única: Cada transação com ID exclusivo
  • Webhooks detalhados: Dados completos para conciliação
  • Relatórios automáticos: Integração com sistemas de gestão
  • API de consulta: Busca histórica de transações

​
Próximos Passos

PIX Cobrança

Aprenda a gerar QR Codes para receber pagamentos

PIX Saque

Realize transferências para chaves PIX

Webhooks PIX

Configure notificações em tempo real

Ambiente de Testes

Teste sua integração no sandbox