Guia de Integração | Widepay

1. Introdução

A integração com APIs Bancárias para a emissão de cobranças representa um avanço estratégico para empresas que buscam automatizar e otimizar sua gestão financeira. Ao conectar diretamente o SGP às instituições bancárias, elimina-se a necessidade de processos manuais, como geração de arquivos de remessa e importação de retornos, reduzindo significativamente erros operacionais e retrabalhos.

Entre os principais benefícios dessa integração destacam-se:

• Automatização do processo de cobrança: o boleto é emitido e registrado automaticamente no banco a partir do SGP, garantindo maior agilidade e conformidade com as regras bancárias.

• Redução de erros e inconsistências: a comunicação direta evita falhas comuns em processos manuais, como duplicidade de boletos ou divergências de valores.

• Maior segurança e confiabilidade: os dados são transmitidos de forma padronizada e segura, minimizando riscos de fraudes ou informações incorretas.

• Controle centralizado: todas as informações financeiras ficam concentradas no SGP, facilitando o acompanhamento de recebimentos e inadimplência.

• Agilidade na tomada de decisão: relatórios atualizados permitem uma visão clara da saúde financeira da empresa.

Assim, a integração bancária não apenas simplifica o processo de cobrança, mas também proporciona maior eficiência operacional, segurança e controle estratégico sobre o fluxo de caixa da organização.

Antes de iniciar o processo, consulte nossa FAQ – Atenção à Segurança da sua Integração! para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Nessa etapa é preciso acessar a plataforma do Widepay 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:

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

3. Integração do Portador

Mesmo sendo uma integração via API, os dados da conta são necessários para a emissão dos boletos.

Na guia Dados Bancários configure:

Em seguida, na guia Relacionamentos da Empresa selecione:

Confirme essas informações com o cliente para evitar rejeição de boletos por dados incorretos.

Por fim, devemos configurar os Juros e Multa, acessando a guia Juros, Multas, Descontos e Taxas

O Widepay aceita apenas as opções:

Para uma melhor compreensão, recomendamos a leitura da nossa documentação de Configuração de Juros e Multa

4. Ponto de Recebimento (Caixa)

O ponto de recebimento é o local onde os pagamentos de boletos serão registrados. 

5. Cadastro do Gateway de Boletos

Agora vamos integrar o Gateway ao SGP para emissão de boletos.

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

A URL de Notificação também deve ser cadastrada na plataforma do Widepay para que os retornos ocorram

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

6. Cadastro do Gateway de Boleto Hibrido

O caminho de acesso é o mesmo do cadastro de Gateway de Boleto, apenas devemos ajustas os dados preenchidos.

Caso já tenha um integração, basta habilitar os campos necessários para ativar o Boleto Híbrido no Gateway de boleto existente, sem a necessidade de criar um novo gateway.

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

A URL de Notificação também deve ser cadastrada na plataforma do Widepay para que os retornos ocorram

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

7. Cadastro do Gateway PIX

O caminho de acesso é o mesmo do cadastro de Gateway de Boleto, apenas devemos ajustas os dados preenchidos.

Esse modelo de integração é apenas para emissão de QRCode PIX, caso queira uma integração de Boleto Hibrido, usar o processo da seção anterior!

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

A URL de Notificação também deve ser cadastrada na plataforma do Widepay para que os retornos ocorram

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

8. Informações Adicionais