¶ Lytex
A integração com a plataforma Lytex 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 Lytex para:
- Emitir Boletos
- Emitir Boletos + PIX
- Cancelar Boletos
- Alterar Vencimento de boletos
- Verificar Pagamentos
¶ Gerar Credencias de Integração - Painel Lytex
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta Lytex.
Com a sua conta aberta, acesse o paínel da Lytex (https://pay.lytex.com.br/auth/login) e vá até o menu Configurações > Integrações, e clique em API, conforme a imagem abaixo:
Em seguida, digite o nome da aplicação, descrição e clique em salvar:
Agora é necessário copiar as credencias que vão ser utilizadas na HubSoft:
- Copie o Client ID
- Copie o Client Secret
Em breve, vamos precisar voltar nesta página para cadastrar a URL de Notificação, mas fique tranquilo, falaremos dela logo abaixo.
¶ Adicionar 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 Lytex, e vamos precisar do Client ID e Client Secret, que você coletou no painel do Lytex.
Preencha os parâmetros desejados da imagem acima, os obrigatórios são:
- client_id: client_id coletado no painel do Lytex
- client_secret: secret coletado no painel do Lytex
- email_padrao: (Obrigatório) Para o registro de um boleto na Lytex, é 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. (Exemplo: email@email.com)
- telefone_padrao: (Obrigatório) Para o registro de um boleto na Lytex, é essencial fornecer o telefone do cliente. O telefone cadastrado será sempre utilizado, mas, na ausência de um telefone do cliente, o telefone fornecido neste parâmetro será usado. (Exemplo: 37999999999)
Feito isso clique em Salvar
Após a integração ser criada, agora precisamos coletar o Callback URL que foi gerado e vincula-lo no painel da Lytex, copie a URL que foi gerada conforme a imagem marcada abaixo:
¶ Adicionar URL Webhook - Painel Lytex
Anteriormente foi informado que iríamos utilizar a URL Webhook (URL de Notificação), seria nesta parte em que iremos utiliza-la.
Vá no painel da Lytex, ative a chave Notificação de pagamentos em tempo real e cole a URL que copiou, apos isso, pode clicar em salvar
¶ Configurar Forma de Cobrança - HubSoft
Agora vamos onfigurar 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 Lytex 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.
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 Lytex, ele foi configurado na etapa «3. Adicionar URL Webhook - Painel Lytex» , 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 Lytex envie Webhooks para o sistema, é importante ter a Rotina de VERIFICA COBRANÇA GATEWAY adicionada, para assim, nenhum boleto ficar sem seu devido recebimento.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados a Lytex. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ É possível enviar baixas automaticamente para a plataforma?
É possível sim, na integração temos o parâmetro opcional chamado transmite_baixa, o mesmo aplicado com o valor true indica que a integração irá transmitir as baixas de títulos, por exemplo: recebimentos na empresa, descontos totais, ou seja, situações onde o título deverá ser baixado no Lytex.
¶ Qual prazo de transmissão de um boleto para a Lytex?
A transmissão de boletos para gateways de pagamento é de 100 boletos a cada 6 minutos.