Como integrar ERP com gateway de pagamento

Você registra o pagamento no sistema, mas o extrato bancário ainda não fechou com o que consta nas contas a receber. O boleto foi pago, o gateway processou, o dinheiro entrou na conta, mas no ERP ainda aparece como pendente. Você vai reconciliar isso na mão, linha por linha, no fim do mês, como sempre.

Esse ciclo consome tempo real e gera risco real. Quando a conciliação bancária depende de conferência manual entre o painel do gateway, o extrato OFX e os lançamentos do financeiro, qualquer divergência vira uma investigação. E divergência em pagamento online tem nome: pode ser chargeback não lançado, taxa de intermediação não provisionada, ou simplesmente um recebimento que entrou líquido quando o sistema esperava o valor bruto.

O que é, de fato, a integração entre ERP e gateway de pagamento

Integração entre ERP e gateway de pagamento é o fluxo pelo qual uma transação processada pelo gateway (boleto, Pix, cartão) gera ou atualiza automaticamente um registro financeiro no ERP, sem que alguém precise copiar dados de um sistema para o outro.

A integração não é só conveniência operacional. É controle de dados financeiros. Sem ela, o saldo que o ERP mostra é sempre uma versão desatualizada da realidade bancária.

Na prática, esse fluxo envolve três camadas:

1. Geração do título: o ERP emite o boleto ou o link de pagamento via API do gateway, já vinculado ao cliente e ao lançamento financeiro correspondente.
2. Confirmação do pagamento: quando o gateway processa o pagamento, ele envia uma notificação (webhook) ao ERP com o status da transação.
3. Baixa e conciliação: o ERP registra a baixa no contas a receber e o valor líquido entra no extrato da conta bancária correspondente, pronto para conciliação OFX.

Cada uma dessas camadas pode funcionar de forma isolada. O erro mais comum é achar que contratar um gateway resolve as três automaticamente.

Como a integração funciona na prática: o fluxo passo a passo

Para uma prestadora de serviço ou distribuidora que emite boleto e recebe via Pix, o fluxo integrado funciona assim:

1. Cadastro da cobrança no ERP Ao fechar uma venda ou registrar uma ordem de serviço, você lança o título no contas a receber com vencimento, valor e centro de custo. Se o ERP está integrado ao gateway, a emissão do boleto ou link de pagamento acontece a partir desse lançamento, sem abrir outro sistema.

2. Envio ao cliente O link ou boleto gerado pelo gateway é enviado diretamente pelo ERP, com os dados do título vinculados. O Portal do Cliente, se disponível no sistema, pode exibir esse link ao próprio cliente sem intervenção manual.

3. Notificação de pagamento via webhook Quando o cliente paga, o gateway envia um evento ao ERP informando o status (pago, parcial, vencido). O ERP usa esse evento para baixar o título no contas a receber.

4. Entrada no extrato e conciliação O valor líquido creditado pelo gateway (já descontada a taxa de intermediação) aparece no extrato da conta bancária no ERP. Na conciliação OFX, você importa o arquivo do banco e o sistema cruza automaticamente os lançamentos já registrados com as entradas reais.

Atenção ao valor líquido: o gateway desconta a taxa antes de depositar. Se o ERP não trata essa diferença, a conciliação vai apresentar divergência em todo recebimento via boleto ou cartão. Provisione a taxa como despesa financeira no plano de contas antes de ativar a integração.

Para referência: tarifas de gateway para boleto no Brasil ficam, em 2026, entre R$ 2,50 e R$ 4,50 por título liquidado, mais percentual sobre cartão de crédito entre 1,8% e 3,5% dependendo do volume e do prazo de recebimento.

Erros que aparecem quando a integração não está bem configurada

Taxa de intermediação não parametrizada no plano de contas O recebimento entra no banco como valor líquido, mas o título no ERP tem o valor bruto. A diferença aparece como "a conciliar" todo mês. Solução: criar uma conta analítica específica para tarifas de gateway e configurar o ERP para lançar a diferença automaticamente na baixa.

Webhook não configurado ou com URL desatualizada O gateway processa o pagamento, mas o ERP não recebe a notificação. O título continua em aberto. O responsável financeiro só descobre quando o cliente reclama que pagou e o sistema ainda mostra pendente. Esse tipo de falha é mais comum após migrações de servidor ou atualização de sistema.

Conciliação feita antes da baixa automática processar Se você importa o OFX antes de o gateway enviar o webhook, o lançamento bancário aparece sem correspondência no extrato do ERP. A conciliação trava. O processo correto é aguardar a baixa automática antes de importar o extrato, ou criar uma rotina de verificação de títulos pendentes com data de pagamento confirmada pelo gateway.

Falta de rastreio por canal de pagamento Quando boleto, Pix e cartão caem na mesma conta bancária sem identificação de origem, o DRE não consegue separar receita por canal. Isso importa para análise de custo de recebimento: cartão parcelado tem custo de antecipação diferente de Pix, e misturar os dois distorce a margem real por tipo de venda.

Como estruturar a integração no seu sistema de gestão

A questão prática é: como integrar meu sistema de gestão com gateway de pagamento de forma que a conciliação feche sem trabalho manual?

O caminho tem quatro etapas objetivas:

1. Mapeie os canais de recebimento que você usa hoje. Boleto, Pix, cartão presencial, link de pagamento remoto. Cada canal pode ter gateway diferente e comportamento diferente na conciliação.

2. Verifique quais gateways o seu ERP suporta via integração nativa. Integração nativa significa que o sistema já tem o conector pronto, sem necessidade de desenvolvimento. Isso elimina custo de implantação e reduz risco de falha no webhook.

3. Configure o plano de contas antes de ativar. Crie as contas analíticas para tarifas de gateway, separadas por canal. Defina o centro de custo correspondente. Isso garante que o DRE já reflita o custo financeiro de cada canal desde o primeiro lançamento.

4. Teste o fluxo completo com um título real antes de migrar o volume. Emita um boleto de valor simbólico, pague, verifique se a baixa aconteceu, importe o OFX e confirme que a conciliação fechou sem divergência. Só depois ative para o volume normal.

No 77Gestão, o módulo Financeiro centraliza contas a pagar e receber, extrato, conciliação OFX e DRE num único ambiente. A parametrização do plano de contas e dos centros de custo acontece antes de qualquer integração, o que garante que os lançamentos gerados por recebimentos externos já entram classificados corretamente.

Conclusão

Integração entre ERP e gateway não é um projeto de TI. É uma decisão financeira. Cada mês sem ela é mais uma rodada de conciliação manual, mais uma chance de divergência não detectada a tempo, mais um DRE fechado com dado incompleto.

O processo descrito aqui funciona independente do sistema que você usa. O que muda é quanto trabalho manual sobra depois que você configura cada etapa corretamente.

Se quiser validar como o fluxo de conciliação OFX e o lançamento de recebimentos via gateway funcionam num ambiente real, crie sua conta em app.77gestao.com.br/cadastro, configure o plano de contas no módulo Financeiro e registre um título de teste com baixa manual para ver a estrutura antes de conectar qualquer gateway.