# Integração Bancária Cel_cash  

Este documento apresenta **instruções detalhadas** sobre a integração e utilização do **Gateway Cel_cash**.  

O **Gateway** melhora o **fluxo de cobranças**, permitindo:  
- Emissão de **boletos híbridos** (boleto com Pix).  
- Registro de cobranças diretamente no **sistema**.  
- **Recebimento automático**, eliminando a necessidade de gerar ou processar **arquivos de remessa e retorno**.  

> [!NOTE] **Requisitos Importantes**  
> - **Sistema operacional Debian 10**.  
> - Para a **homologação de uma carteira Gateway**, o ideal é abrir um **novo convênio bancário**. Caso opte por utilizar um já existente no sistema e com boletos emitidos, esteja ciente de possíveis **divergências nos relatórios de retorno**, como:  
>   - **Títulos não encontrados** nos processamentos de retorno, referentes à carteira Gateway.  
>   - **Liquidações associadas a boletos divergentes**.  

## Objetivos da Integração  

- **Expandir** as opções de integração do sistema.  
- Atender às **demandas dos clientes** que buscam compatibilidade com essa integração.  
- Implementar a **emissão automática de boletos híbridos** e **processar a baixa de pagamentos** de forma integrada e eficiente.  
- Oferecer **mais uma opção de integração**, garantindo **flexibilidade na gestão de soluções financeiras**.  

## Benefícios da Integração  

### 1. Automação de Processos  
- **Emissão e registro automático:** A emissão e o registro de **boletos híbridos** são realizados automaticamente pelo **Gateway**, reduzindo a necessidade de **intervenções manuais**.  
- **Baixa automática de pagamentos:** Os pagamentos são baixados automaticamente no sistema, garantindo **maior precisão** e **economia de tempo**.  

### 2. Economia e Eficiência  
- **Redução de custos:** Com as **tarifas competitivas** da **Cel_cash**, os clientes economizam nas **transações financeiras** enquanto utilizam uma solução integrada.  
- **Centralização de operações:** Permite gerenciar **boletos e pagamentos em uma única plataforma**, evitando a necessidade de utilizar **múltiplos sistemas e fornecedores**.  

### 3. Melhor Experiência para o Cliente  
- **Solicitação atendida:** Atende à **demanda dos clientes** que já utilizam a **Cel_cash** e desejam manter seus serviços integrados ao sistema.  
- **Facilidade de adoção:** Desenvolvida para ser **intuitiva e de fácil implementação**, permitindo que os clientes **utilizem a integração imediatamente**.  

### 4. Vantagem Competitiva  
- **Maior atratividade do sistema:** Com essa nova integração, a plataforma se torna **mais atrativa para novos clientes** que utilizam ou desejam aderir à **Cel_cash**.  
- **Retenção de clientes:** Ao oferecer soluções alinhadas às **necessidades dos usuários**, o sistema contribui para o **aumento da satisfação e retenção de clientes**.

## Processo de Integração e Homologação
Para realizar a integração e homologação do Gateway Cel_cash no sistema, siga estes passos:

### Homologação
> [!EXAMPLE] Dados bancários necessários para a integração:
>
> **Cel_cash (Gateway)**
>
> * 1 - Número da agência com dígito?
> * 2 - Número da conta com dígito?
> * 3 - Galax Pay ID?
> * 4 - Galax Pay Hash?

> [!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 do Gateway
1. Acesse o [Internet Banking Cel_cash](https://celcash.celcoin.com.br/v2/login)
2. Faça login com sua Conta
3. Na conta Cel_cash, clique no menu **Módulos**
4. No módulo **Webservice** clique em **Configurar**
5. Selecione a opção **IXC** na lista de softwares parceiros e clique no botão **Configurar**
5. Clique em **Confirmar** e no parâmetro **URL Webhook** insira o endereço URL de acesso ao seu IXC, acrescido de **/retorno_galax_pay.php**
	* Exemplo: **[https://ixc.provedor.com.br/retorno_galax_pay.php](https://ixc.provedor.com.br/retorno_galax_pay.php)**
6. Clique em **Confirmar**
7. Desça até o final da página e clique em **Salvar informações**

Após este procedimento, copie as informações de **Galax ID** e **Galax HASH**, que você irá usar para configurar a carteira de cobrança conforme o tutorial acima.

> [!SUCCESS] Credenciais Gateway Finalizadas!
> Feito isso, junto com os seus outros dados bancários, o atendente 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. Pasta **Financeiro**
3. E clique em **Carteira de cobrança**
4. Clique em **Novo**
5. Na primeira aba chamada **Carteira de cobrança**, você fará as seguintes configurações:
	- **Descrição:** Aqui você irá definir a nomeação da carteira
	- **Conta:** Aqui você irá criar a conta, responsável por armazenar seus dados bancários
	- **Tipo de recebimento:** Neste campo você deve selecionar a opção **Gateway**
	- **Enviar e-mail para cliente ao gerar:** Marcar como **Não**, pois torna obrigatório o e-mail de cadastro do cliente e envia automaticamente a fatura do cliente, fazendo assim o registro da mesma no banco (sendo assim, não é recomendado o uso)
	- **Validar filial na venda:** Marcar como **Sim**
	- **Planejamento analítico:** utilize o padrão **240**, ou cadastre um novo

### Criando a Conta
- **Conta:** Defina o nome para a conta
- **Tipo da Conta:** Marque a opção **Banco**
- **Data de abertura:** Informe o dia 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 será criada esta **Conta** e a **Carteira** 

Na aba seguinte **Banco:**
- **Banco:** Como a Cel_cash não é associada ao Banco Central, não precisa preencher este campo
- **Agência:** Número da sua agência bancária
- **Dígito verificador da agência:** Insira o dígito verificador que fica após o número da agência
- **Número da conta:** Número da sua conta bancária
- **Dígito verificador da conta:** Informe o dígito verificador de sua conta bancária

### Configurações Gateway
- **Gateway:** Selecione o **GalaxPay**
- **Ambiente gateway:** Selecione **Produção**
- **Galax Pay ID**: Insira o ID de sua carteira Cel-cash (Galax Pay) que foi criada no site
- **Galax Pay Hash**: Insira o código também gerado na aplicação do site
- **Envia e-mail Gateways:** Marque como **Não**
- **Gera pix:** Marque como **Sim**, ser for utilizar o Pix no boleto
- **Tarifas Gateway:** aqui você define o lançamento das tarifas gateway, pois o banco não faz isso de forma automática. Acesse [[tarifas bancarias - gateway, api e pix|Tarifas Bancárias - Gateway, API e Pix]] para mais informações

> [!TIP] Dica!
> Após clicar em **Salvar** a carteira, os campos Webhook ID e Webhook serão preenchidos automaticamente pelo sistema.

### Juros/Multas/Desconto
- **Juros %:** Valor padrão (máximo permitido por lei, acima é caracterizado juros abusivo), configure 0.033%
- **Multa %:** Valor padrão (máximo permitido por lei, acima é caracterizado multa abusiva), configure 2%
- **Desconto até o vencimento R$:** Insira um valor em **Reais** para conceder desconto na fatura, se paga até a data do vencimento
- **Desconto até o vencimento %:** Insira um valor em **Porcentagem** para conceder desconto na fatura, se paga até a data do vencimento

Para mais informações, acesse: [[juros, multas e desconto|Juros, Multas e Desconto]]

### Instruções
> [!INFO] Informação:
> * Cel_cash Gateway permite o uso de no máximo **255 caracteres** totais para serem inseridos como linha de instrução na impressão do boleto.  
> * Não tem 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] Atenção!
> 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 Cel_cash
    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
```

### Ativação  

> [!SUCCESS] **Finalizado!**  
> Com todos os passos concluídos, a carteira está configurada. Agora, um **boleto teste** pode ser gerado para efetuar o pagamento e validar a **baixa automática da fatura** no sistema.  
> Após a baixa ser processada corretamente, a **homologação estará concluída**.  

## Considerações Finais  

A **integração entre a Cel_cash e o IXC Provedor** representa um avanço significativo para prover um **ambiente mais eficiente** na **gestão financeira dos provedores de serviço**.  

Com **automação, redução de custos** e suporte às necessidades dos clientes, essa parceria reforça um caminho para **operações financeiras mais ágeis, seguras e simplificadas**.

## Etiquetas
#IntegracaoBancaria #GatewayBancario #Cel_cash #GatewayDePagamento #BoletoHibrido #BoletoPix #Pix

## 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]]
* [[rotina alteracao de cadastro galax pay|Rotina Alteração de Cadastro Galax Pay]]
* **Manual Gateway Cel_cash**: https://docs-celcash.celcoin.com.br/