Central de Ajuda

Leitura de 4 min

Introdução

Com o avanço das integrações bancárias e devido à necessidade de ajustes nos serviços de comunicação, foi realizada uma atualização nas rotas da API associada à Efí Bank. As rotas antigas, baseadas no domínio “gerencianet”, serão descontinuadas a partir de 20 de dezembro de 2024. Este documento detalha o processo de configuração necessário para manter suas integrações funcionando corretamente após a alteração.

Aviso!

Essas alterações são fundamentais para garantir a continuidade do serviço e aproveitar as melhorias oferecidas com as novas rotas hospedadas no Efí Bank. A conectividade reformulada assegura maior segurança, estabilidade e compatibilidade com as novas tecnologias.

Objetivo

O objetivo deste documento é instruir, de forma clara e objetiva, os usuários sobre como implementar as alterações necessárias nas rotas de comunicação das APIs associadas ao Efí Bank. Além disso, ele busca explicar os benefícios das mudanças, fornecer instruções práticas para parametrização do ambiente e destacar as principais implicações dessas atualizações.

Benefícios

A atualização traz os seguintes benefícios aos usuários:

  • Maior estabilidade no consumo das APIs com hospedagem na Efí Bank.
  • Melhorias na segurança das conexões API com certificados atualizados.
  • Integração simplificada com suporte contínuo às funcionalidades Pix, Cobranças e Pagamentos.
  • Adoção de padrões mais modernos e compatíveis com melhorias futuras.

Atualização Rota APIs Efí Bank - Gerencianet

  • Para API Pix:
    • Ambiente de Produção:
      Substitua https://api-pix.gerencianet.com.br por https://pix.api.efipay.com.br.
    • Ambiente de Homologação:
      Substitua https://api-pix-h.gerencianet.com.br por https://pix-h.api.efipay.com.br.
  • Para API Cobranças:
    • Ambiente de Produção:
      Substitua https://api.gerencianet.com.br por https://cobrancas.api.efipay.com.br.
    • Ambiente de Homologação:
      Substitua https://api-h.gerencianet.com.br por https://cobrancas-h.api.efipay.com.br.
  • Para API Pagamentos:
    • Ambiente de Produção:
      Substitua https://apis.gerencianet.com.br por https://pagarcontas.api.efipay.com.br.
    • Ambiente de Homologação:
      Substitua https://apis-h.gerencianet.com.br por https://pagarcontas-h.api.efipay.com.br.

Impactos na Mudança

  1. Descontinuidade de rotas antigas: A partir de 20 de dezembro de 2024, qualquer integração que continue utilizando os domínios gerencianet será inutilizada.
  2. Mudanças na estrutura de código: As dependências e instâncias de classes relativas à Gerencianet precisarão ser atualizadas.
  3. Benefícios operacionais: Além da continuidade no serviço, haverá melhorias em desempenho, segurança e suporte a novos recursos.

Ajustes Necessários para Configurações de Rede

Não será necessário realizar nenhuma alteração diretamente em suas carteiras de cobrança, utilizadas para emitir cobranças ou faturas através das APIs da Efí Bank. A atualização das rotas da API é uma alteração interna do sistema que não impacta a funcionalidade do uso regular das carteiras de cobrança.

Contudo, provedores que utilizam regras específicas de bloqueio de rede e firewall, e configuram manualmente os acessos às rotas das APIs da Efí Bank, devem ajustar os domínios em suas configurações de rede do servidor.

Aviso!

Não é necessário atualizar as rotas de ambiente de Homologação, pois são apenas para testes. Você irá utilizar somente as de ambiente de Produção.

Novas rotas que precisam ser liberadas:

  • API Pix
    • Produção: https://pix.api.efipay.com.br
  • API Cobranças
    • Produção: https://cobrancas.api.efipay.com.br
  • API Pagamentos
    • Produção: https://pagarcontas.api.efipay.com.br

Certifique-se de que as novas rotas estejam devidamente configuradas e liberadas para permitir a comunicação entre o servidor e a Efí Bank. Essa adequação é essencial para garantir a continuidade da operação, especialmente no caso de ambientes com restrições de rede.

Considerações Finais

A alteração nas rotas das APIs Efí Bank é uma mudança essencial para a continuidade e evolução dos serviços financeiros integrados. Ao seguir este passo a passo, os usuários garantirão a funcionalidade de suas integrações, além de desfrutarem dos avanços introduzidos pelas novas rotas e infraestrutura do Efí Bank. Lembre-se de testar todas as alterações antes de aplicá-las em produção.

ETIQUETAS

API Pix Cobrancas Pagamentos Integracoes EfiBank

LEIA TAMBÉM

Visão de gráfico