Guia de Integração | Iugu
1. Configurando a Carteira do Iugu
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 Iugu 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 Iugu 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: G04 - Iugu
- Descrição: Iugu
- 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 Iugu 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: Iugu
- Descrição: Iugu
- Usuário: Client ID
- TOKEN: Token gerado na plataforma Iugu
- Habilite Pagamentos via PIX
- Selecione o Portador Iugu
- URL de Notificação: https://url_do_seu_sgp/ws/iugu/IDGATEWAY/notificacao/
- Parâmetros: pixvencimento
- Ponto de Recebimento: Iugu
- Layout Cobrança PIX: Layout 0
- Gerar Boleto/Carnê + Pix?: 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 BOLETO + 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 Iugu Boleto - Registro ✔️ Boleto - Retorno ✔️ Boleto - Cancelamento ✔️ Boleto - Tempo de Retorno Rotina PIX - Emissão ✔️ PIX - Cancelamento ✔️ PIX - Tempo de Baixa Rotina PIX Híbrido ou Avulso? Ambos -
