Integração Bancária Lytex
Este documento apresenta instruções detalhadas sobre a integração e o uso do Gateway Lytex, incluindo a configuração do Webhook para notificações em tempo real. O Gateway automatiza processos bancários, enquanto o Webhook garante atualizações instantâneas sobre transações e eventos.
Requisitos Importantes
- Sistema operacional Debian 10.
- Para homologar uma carteira Gateway, o recomendado é abrir um novo convênio de conta bancária. Caso deseje utilizar uma conta já cadastrada no IXC e que já possui boletos emitidos, é importante estar ciente de que podem ocorrer divergências nos relatórios gerados a partir dos arquivos de retorno.
Entre essas divergências, podem ocorrer: falha na identificação de títulos no processamento de retorno (relacionados à carteira de Gateway), baixas vinculadas a boletos divergentes, entre outros casos.
Objetivos da Integração
- Ampliar as opções de integração do Sistema.
- Atender aos clientes da Lytex que buscam compatibilidade com o Sistema.
- Permitir a emissão automática de boletos híbridos e o processamento integrado da baixa de pagamentos.
- Oferecer mais uma alternativa de integração para os clientes, aumentando a flexibilidade na escolha de soluções financeiras.
Benefícios da Integração
1. Automação de Processos
- Baixa automática de pagamentos: os pagamentos realizados serão baixados automaticamente no Sistema, garantindo mais precisão e economia de tempo.
2. Economia e Eficiência
- Redução de custos: com tarifas competitivas da Lytex, os clientes economizam em transações financeiras usando uma solução integrada.
- Centralização de operações: permite gerenciar boletos e pagamentos em uma única plataforma, evitando o uso de múltiplos sistemas e fornecedores.
3. Melhor Experiência para o Cliente
- Atendimento à demanda: a integração atende a clientes que já possuem contas na Lytex e desejam continuar utilizando seus serviços dentro do Sistema.
- Facilidade de implementação: foi projetada para ser intuitiva e de rápida adoção, permitindo seu uso imediato.
4. Vantagem Competitiva
- Mais atratividade para o Sistema: com essa integração, a plataforma se torna mais interessante para novos clientes que já utilizam ou desejam utilizar a Lytex.
- Maior retenção de clientes: ao oferecer soluções solicitadas pelos usuários, o Sistema melhora suas taxas de retenção e satisfação.
Processo de Integração e Homologação
Para realizar a integração e homologação da Gateway Lytex no sistema, siga estes passos:
Homologação
Dados bancários necessários para a integração:
Lytex (Gateway)
- 1 - Número da agência com dígito?
- 2 - Número da conta com dígito?
- 3 - Client_ID?
- 4 - Client_Secret?
Dica!
Caso tenha dúvida sobre algum dos dados bancários, consulte o(a) Gerente de sua Conta Bancária.
Passo a Passo para Obter as Credenciais da Gateway
Informação!
Para homologar a carteira de Gateway do Lytex, também é necessário gerar o Client_ID e o Client_Secret, que são as credenciais da aplicação da Gateway geradas no Internet Banking da Lytex.
- Acesse o Internet Banking Lytex.
- Faça login com sua conta.
- No menu lateral esquerdo, clique em Configurações.
- Selecione Integrações e, em seguida, clique em Gateway.
- No formulário de Nova Integração, preencha os dados no campo Nome da aplicação e clique em Salvar.
- No canto direito da tela, serão geradas as chaves Client_ID e Client_Secret, copie esses códigos para utilizá-los na criação da carteira de cobrança no sistema.
Aviso!
No campo Notificação de pagamentos em tempo real?, insira a URL de callback da Gateway, que é gerada dentro da Carteira de Cobrança, na aba Configurações Gateway.
Credenciais Gateway Finalizadas!
Com isso, juntamente com seus demais dados bancários, a equipe de atendimento da IXC Soft poderá prosseguir com a homologação da sua carteira de cobrança de Gateway.
Criando a Carteira
- Acesse o menu Sistema.
- Entre na pasta Financeiro.
- Clique em Carteira de cobrança.
- Clique em Novo.
- Na primeira aba, chamada Carteira de cobrança, configure os seguintes campos:
- Descrição: Defina um nome para a carteira.
- Conta: Crie a conta responsável por armazenar os dados bancários.
- Tipo de recebimento: Escolha a opção Gateway.
- Enviar e-mail para cliente ao gerar: Selecione Não, pois essa opção exige que o cliente tenha e-mail cadastrado e envia automaticamente a fatura ao banco, não sendo recomendada.
- Validar filial na venda: Selecione Sim.
- Planejamento analítico: Utilize o padrão 240 ou cadastre um novo.
Criando a Conta
- Conta: Defina um nome para a conta.
- Tipo da Conta: Marque Banco.
- Data de abertura: Informe a data em que está configurando a conta para esta carteira.
- Planejamento analítico: Para mais informações, acesse: Formulário Planejamento Analítico.
- Filial: Selecione o ID da filial para a qual a Conta e a Carteira serão criadas.
Na aba Banco:
- Banco: Como a Lytex não é associada ao Banco Central, este campo não precisa ser preenchido.
- Agência: Digite o número da agência bancária.
- Dígito verificador da agência: Insira o dígito verificador localizado após o número da agência.
- Número da conta: Informe o número da conta bancária.
- Dígito verificador da conta: Digite o dígito verificador da conta bancária.
Configurações Gateway
- Gateway: Selecione Lytex.
- Ambiente gateway: Escolha Produção.
- Client_ID: Insira o código gerado anteriormente em sua conta Lytex.
- Client_Secret: Insira o código gerado anteriormente em sua conta Lytex.
- Webhook: Clique no botão Gerar para criar a URL de comunicação da sua carteira com a Gateway da Lytex.
Aviso!
Webhook: Copie a URL gerada e utilize-a na configuração de notificação de pagamentos dentro da sua conta Lytex. Insira esta URL no campo Notificação de pagamentos em tempo real?, no menu Gateway > Integração.
- Envia e-mail Gateways: Selecione Não.
- Gera Pix: Escolha Sim caso vá utilizar Pix no boleto.
- Tarifas Gateway: Defina o lançamento das tarifas, pois o banco não faz isso automaticamente. Para mais informações, acesse Tarifas Bancárias - Gateway, API e Pix.
Juros/Multas/Desconto
- Juros %: Configure 0.033%, respeitando o limite legal.
- Multa %: Configure 2%, limite máximo permitido por lei.
- Desconto até o vencimento R$: Informe um valor fixo em Reais para desconto em pagamentos até a data do vencimento.
- Desconto até o vencimento %: Insira um percentual de desconto para pagamentos realizados até o vencimento.
Para mais informações, acesse: Juros, Multas e Desconto.
Aviso!
A Gateway Lytex exige um valor mínimo de R$2,00 para o registro de uma cobrança.
Instruções
Informação:
- A Lytex Gateway permite no máximo 300 caracteres para a linha de instrução impressa no boleto.
- Não há limite de linhas.
Remova as aspas antes e depois das hashtags abaixo:
- Instrução 1:
Após vencimento juros R$ #juro# ao dia.
- Instrução 2:
Após vencimento multa R$ #multa#.
Aviso!
Caso adicione mais linhas, também deve inserir a variável de leitura da linha de instrução, nos parâmetros Imprimir instruções quando…
Para mais informações, acesse: Instruções da Carteira de Cobrança.
Impressão
- Layout de impressão: Utilize o padrão 3 por página.
Para mais informações, acesse: Layouts de Impressão.
Fluxo de Funcionamento
sequenceDiagram participant S as Sistema participant Gateway as Gateway Lytex participant W as Webhook S->>Gateway: Envia requisição (ex: gerar boleto) Gateway->>S: Responde com dados do boleto Note over Gateway,W: Evento ocorre (ex: pagamento) W->>S: Notifica sobre o evento S->>Gateway: Confirma recebimento da notificação
Tarefa de Consulta de Retorno
Dica:
Caso queira uma garantia adicional de baixa de pagamentos, além do webhook, também é possível configurar uma tarefa que consulta os pagamentos.
Esta tarefa deve ser configurada para executar somente 1x no dia, pela manhã, e com isso sempre irá consultar os pagamentos dos títulos que vencem no dia anterior.
Para realizar a configuração, acesse:
- Menu Ferramentas
- Clique em Ferramentas
- Agenda de tarefas
- Botão Novo
- Tarefa: Selecione Processamento retorno Lytex Gateway
- Minuto (0-59): Coloque o valor dos minutos, entre 0 e 59 min
- Hora (0-23): Coloque o valor da hora, entre 0 e 23
Ativação
Finalizado!
Depois de concluir todos os passos anteriores, a carteira e as tarefas de consulta estarão prontas. Com isso, já é possível gerar um boleto de teste para realizar o pagamento e verificar a baixa da fatura no Sistema.
Quando a baixa da fatura for processada automaticamente, a homologação estará concluída.
Atenção!
Os títulos gerados por essa integração são emitidos pelos bancos Banco do Brasil, Santander ou Itaú, pois a Lytex atua como intermediadora dessas instituições.
Considerações Finais
A integração entre a Lytex e o Sistema representa um avanço importante para melhorar o funcionamento dos negócios dos provedores de serviço. Com processos automatizados, redução de custos e suporte às necessidades dos clientes, essa parceria contribui para um gerenciamento financeiro mais eficiente e simples.
Etiquetas
IntegracaoBancaria GatewayBancaria Lytex