# 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.  

> [!NOTE] 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
> [!EXAMPLE] 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?

> [!TIP] 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  

> [!INFO] 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.  

1. Acesse o [Internet Banking Lytex](https://pay.lytex.com.br/auth/login).  
2. Faça login com sua conta.  
3. No menu lateral esquerdo, clique em **Configurações**.  
4. Selecione **Integrações** e, em seguida, clique em **Gateway**.  
5. No formulário de Nova Integração, preencha os dados no campo **Nome da aplicação** e clique em **Salvar**.  
6. 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.  

> [!WARNING] 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**.  

> [!SUCCESS] 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  
1. Acesse o menu **Sistema**.  
2. Entre na pasta **Financeiro**.  
3. Clique em **Carteira de cobrança**.  
4. Clique em **Novo**.  
5. 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: [[formulario planejamento analitico|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.  

> [!WARNING] 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 bancarias - gateway, api e pix|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|Juros, Multas e Desconto]].  

> [!WARNING] Aviso!  
> A Gateway Lytex exige um valor mínimo de **R$2,00** para o registro de uma cobrança.  

### Instruções  
> [!INFO] 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#.
```

> [!WARNING] 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: [[instrucoes da carteira de cobranca|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 impressao|Layouts de Impressão]].

## Fluxo de Funcionamento
```mermaid
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
> [!TIP] 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:
1. Menu **Ferramentas**
2. Clique em **Ferramentas**
3. **Agenda de tarefas**
4. Botão **Novo**
5. **Tarefa:** Selecione **Processamento retorno Lytex Gateway**
6. **Minuto (0-59):** Coloque o valor dos minutos, entre 0 e 59 min
7. **Hora (0-23):** Coloque o valor da hora, entre 0 e 23

### Ativação  
> [!SUCCESS] 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.  

> [!WARNING] 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 

## Leia Também
* [[carteira de cobranca|Carteira de Cobrança]]
* [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
* [[integracoes bancarias - gateway|Integrações Bancárias - Gateway]]
* [[como solicitar o pix na central do assinante|Como Solicitar o Pix na Central do Assinante]]
* **Manual Gateway Lytex**: https://docs-pay.lytex.com.br/documentacao/v2