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.
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
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?
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
- Acesse o Internet Banking Cel_cash
- Faça login com sua Conta
- Na conta Cel_cash, clique no menu Módulos
- No módulo Webservice clique em Configurar
- Selecione a opção IXC na lista de softwares parceiros e clique no botão Configurar
- 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
- Clique em Confirmar
- 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.
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
- Acesse o menu Sistema
- Pasta Financeiro
- E clique em Carteira de cobrança
- Clique em Novo
- 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: 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 Bancárias - Gateway, API e Pix para mais informações
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
Instruções
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#.
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: 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 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
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