Guia de Integração | Modobank
1. Configurando a Carteira do ModoBank - PIX
Você pode cadastrar a carteira bancária de seus clientes para facilitar o controle de cobranças e pagamentos. Isso ajuda a manter as informações organizadas e evita a necessidade de digitar os dados bancários a cada operação.
Com a carteira configurada, o sistema consegue gerar boletos e processar pagamentos automaticamente, reduzindo erros e agilizando o trabalho diário.
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.
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 Modobank 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
- Chave PIX
Durante essa etapa, crie a aplicação no ModoBank 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.
- Você será direcionado para a página de cadastro de Portador, onde poderá inserir e configurar os dados necessários.
Na guia Dados Bancários configure:
- Código do Banco: 999 - Cobrança Local
- Descrição: ModoBank PIX
- Agência: 0
- Conta Cedente: 0
- Carteira: 0
Em seguida, na guia Relacionamentos da Empresa selecione:
- Empresa beneficiária
- Nome do beneficiário
- CPF ou CNPJ do beneficiário
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 ModoBank aceita apenas a opção:
- Percentual Multa, Percentual Juros ao dia
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.
- Na guia Dados Básicos, defina o Nome do caixa e selecione o Portador padrão.
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:
- Nome da Integração: ModoBank PIX
- Descrição: ModoBank PIX API
- Usuário: Client ID
- Senha: Client Secret
- Chave PIX: Defina a Chave gerada
- Habilite Pagamentos via PIX
- Selecione o Portador ModobankPIX
- URL de Notificação: https://url_do_seu_sgp/ws/pix/notificacao/
- Parâmetros: pixvencimento
- Ponto de Recebimento: Modobank PIX
- Gerar Boleto/Carnê + Pix Avulso?: Selecionar
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
Imagem de Referência (API PIX)
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
6. 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.
- Para identificá-lo, siga os passos:
-
A seguir, listamos algumas funcionalidades disponíveis para a sua integração:
Funcionalidade Modobank PIX PIX - Emissão ✔️ PIX - Cancelamento ✔️ PIX - Tempo de Baixa Webhook PIX Híbrido ou Avulso? Avulso
