¶ Iugu
A integração com a plataforma Iugu tem como objetivo principal, a emissão e compensação de boletos bancários. Através de APIs, o HubSoft irá se comunicar com a Iugu para:
- Emitir Boletos
- Emitir Boletos + PIX
- Cancelar Boletos
- Verificar Pagamentos
- Webhooks Pagamentos
¶ 1. Gerar Credenciais - Painel Iugu
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta Iugu.
Com a sua conta aberta, acesse o painél da Iugu (https://alia.iugu.com/) e vá até o menu Configurações > Desenvolvedor > Integrações via API, e clique em Novo:
Escolha o Tipo como Produção, e digite a descrição do Token e clique em salvar:
Agora é necessário copiar o Token, ele será utilizado na HubSoft.
- Obs: O Token só fica visível por uma hora.
Em breve, vamos precisar voltar aqui para cadastrar a URL de Notificação, mas fique tranquilo, falaremos dela logo abaixo.
¶ 2. Adiconar Integração - HubSoft
Agora, com todos os dados em mãos, vamos até o HubSoft para cadastrar a Integração
O primeiro passo é acessar no HubSoft o menu lateral Configuração > Integrações > Pagamento, conforme imagem abaixo
Clique em Adicionar, para inserirmos os dados da Integração
Nessa etapa, escolha o Gateway de Pagamento como Iugu, e vamos precisar do Token, que você coletou no painel do Lytex.
Preencha os parâmetros desejados da imagem acima, os obrigatórios são:
- token: Token da Integração, coletado no painel da Iugu
- email_padrao: Para o registro de um boleto na Iugu, é essencial fornecer o e-mail do cliente. O e-mail cadastrado será sempre utilizado, mas, na ausência de um e-mail do cliente, o e-mail fornecido neste parâmetro será usado.
Feito isso, clique em Salvar
Após a integração ser criada, agora precisamos coletar o Callback URL que foi gerado e vinculá-lo no painél da Iugu, copie a URL que foi gerada conforme a imagem marcada abaixo:
¶ 3. Adicionar URL Webhook - Painel Iugu
Lembra que falamos da URL de Notificação anteriormente? Então, agora chegou a vez dela.
Vá no painel da Iugu, clique em Configurações > Desenvolvedor > Comunicação Via Gatilhos, e clique em Novo:
Adicione a URL que foi copiada na HubSoft, escolha o evento de Fatura liberada, e clique em Salvar:
¶ 4. Configurar Forma de Cobrança - HubSoft
Agora vamos configurar a Forma de Cobrança, que será associada com o seu Cliente e Boletos
Então, no menu lateral acesse o menu Configuração > Financeiro > Forma de Cobrança, conforme imagem abaixo
Clique em Adicionar uma Forma de Cobrança e preencha o Banco como Iugu e selecione a Integração que você acabou de adicionar
Feito isso, acesse a aba Configuração e preencha os dados conforme a imagem abaixo
Feito isso, está tudo pronto para você iniciar a emitir seus boletos no HubSoft de forma integrada ao Lytex.
¶ BOLETO + PIX
Também é possível emitir o Boleto + Pix direto, para isso, na integração, basta adicionar o parametro boleto_pix como true, que quando um boleto for registrado, o mesmo terá os dados do QRCODE.
Antes de ativar na hubsoft, verifique se no seu painel Iugu esta ativo a opção de recebimento por PIX.
Nessa modalidade, ao emitir um boleto bancário, automaticamente já é emitido um PIX com os mesmos dados do boleto. Dessa forma, em um único boleto, o cliente conseguirá pagar utilizando o código de barras ou QR Code do PIX.
¶ WEBHOOK
O Webhook é configurado no painel do Iugu, ele foi configurado na etapa «Adicionar URL Webhook - Painel Iugu» , sendo assim, assim que um boleto constar como pago no sistema do Lytex, eles automaticamente enviam para hubsoft o informe daquele pagamento.
Por mais que a plataforma Iugu envie Webhooks para o sistema, é importante ter a Rotina de VERIFICA COBRANÇA GATEWAY adicionada, para assim, nenhum boleto ficar sem seu devido recebimento.
