Skip to main content

Guia de Integração | GerenciaNet - Efí Checkout (Cartão)

sgptsmx-petroleo.png
1. Introdução

A integração de um gateway de cartão de crédito ao SGP é uma solução fundamental para empresas que desejam oferecer meios de pagamento modernos e seguros aos seus clientes. Essa conexão permite que transações sejam processadas em tempo real, de forma totalmente automatizada, eliminando a necessidade de conciliações manuais e aumentando a eficiência operacional.

Entre os principais benefícios, destacam-se:

  • Agilidade no recebimento: os pagamentos por cartão são processados instantaneamente, acelerando o fluxo de caixa e melhorando a previsibilidade financeira.

  • Segurança nas transações: gateways utilizam padrões avançados de criptografia e protocolos de segurança, reduzindo riscos de fraudes.

  • Melhoria na experiência do cliente: a possibilidade de pagar por cartão de crédito oferece mais conveniência, ampliando as opções de cobrança e aumentando a satisfação do consumidor.

  • Controle centralizado: todas as transações ficam concentradas no SGP, permitindo relatórios unificados e gestão integrada de recebíveis.

Dessa forma, a integração com gateways de cartão de crédito não só amplia as formas de cobrança disponíveis, como também garante maior segurança, rapidez e confiabilidade no processo de gestão financeira da empresa.

Antes de iniciar o processo, consulte nossa FAQ Boas Práticas para uma Integração Segura para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Nessa etapa é preciso acessar a plataforma do Efí para criar uma aplicação que vai fornecer as credenciais em produção para a integração com o SGP.

Você vai precisar dos seguintes dados:

  • Client ID
  • Client Secret

Durante essa etapa, crie a aplicação no Efí seguindo as instruções do suporte do banco.

3. Cadastro do Gateway CheckOut

Agora vamos integrar o Gateway ao SGP para cobranças com cartão

  • No Menu Principal, acesse Financeiro (❶), depois vá em Cadastros (❷) e, em seguida, clique em Gateway de Pagamento (❸).

Modelo_de_imagem_horizontal_com_sombra.png

O Gateway de Checkout pode ser associado a portadores já cadastrados no sistema, habilitando neles a opção de pagamento por cartão.

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: GerenciaNet Checkout
  2. Descrição
  3. Usuário: Client ID
  4. Senha: Client Secret
  5. Habilite Pagamentos via Cartão Crédito
  6. Selecione o(s) Portador(es) que deseja vincular
  7. URL de Notificação: https://url_do_seu_sgp/ws/gerencianet/id_do_gateway/notificacao

Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais

Imagem de Referência (API Cartão CheckOut)

2025-09-29_16-01.png

4. Informações Adicionais
  • No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
    • Para identificá-lo, siga os passos:
      • Crie um gateway deixando o campo “URL de notificação” em branco.
      • Anote o ID gerado.
      • Em seguida, cadastre a URL de notificação utilizando esse ID.
  • Ao efetuar o pagamento de uma cobrança com cartão, o boleto vinculado a essa cobrança, caso já esteja registrado no banco, será automaticamente cancelado.

tsmx-petroleo.png

Back to top