Manual de integração - ISPFY
Saiba como configurar a integração do sistema ISPFY
Configurando a integração - cel_cash
1 - Você deve instalar o módulo “Webservice”:
Clique em “Módulos”, busque por “Webservice” e clique em "Instalar"
2 - Na tela de configuração do módulo selecione a opção “Deseja pré-configurar o cel_cash com algum dos softwares parceiros abaixo?”
Pesquise por “ISPFY" > Selecione a opção > Clique em “Configurar”
3 - Ao clicar em “Configurar” irá aparecer o seguinte alerta abaixo, informe a URL do Webhook e clique em “Confirmar”
Ainda no módulo Webservice você irá:
-
Inserir no campo URL Webhook dentro do cel_cash, a URL que o ISPFY irá disponibilizar a você;
-
No campo Whitelist, insira o “IP do seu servidor ISPFY”, geralmente, o mesmo utilizado para acessá-lo;
Importante: Caso seu servidor tenha algum NAT, que em cada momento envia os dados por um IP de saída, recomendamos que cliquem no botão Desabilitar Whitelist, dessa forma o cel_cash não irá restringir por IP.
Após isso, clique em salvar informações no final da página.
Configurando a integração - ISPFY
Preencha os campos como descrito abaixo:
Alguns campos possuem um ícone representado por uma interrogação "?", ao passar o mouse sobre o ícone, detalhes sobre o campo serão exibidos.
No campo “Multa Atraso”, defina a multa em caso de atraso no pagamento;
Em “Mora Mensal”, defina o total de juros de mora mensal em caso de atraso no pagamento;
Caso você deseje oferecer algum desconto por pagamento antecipado, preencha os campos de desconto;
Confira aqui a matéria sobre como os descontos funcionam
Em “Custo Liqui.” Informe o custo da liquidação do boleto em reais;
Se informado, o valor será debitado do caixa mediante recebimento via notificação.
No campo “Taxa atualiz. (R$)”, você poderá definir uma taxa para a atualização de cobrança em caso de atraso;
Em “Dias Baixa”, defina em quantos dias após o vencimento as cobranças expirarão;
No campo “Recálculo”, define se o ISPFY deverá recalcular a data e o valor de uma cobrança vencida no momento da impressão;
No campo “Imprime”, selecione a opção “sim” para permitir a impressão das cobranças geradas nesta carteira;
Selecione a opção “Local e Remota” no campo “Tipo Impressão”;
Priorize a impressão local, o modo remoto deverá ser utilizado apenas em casos específicos.
Selecione a opção “Produção” no campo “Ambiente”;
A opção teste deve ser utilizada apenas sob orientação do suporte.
Em “Notific. cancelamento", define o comportamento do ISPFY ao receber do gateway um aviso de cancelamento ou baixa manual de uma cobrança;
Caso selecionada a opção “Aceitar”, ao receber notificações de cancelamento ou baixa o ISPFY realizará a mesma operação na cobrança. Prefira a opção “ignorar”, assim o ISPFY deverá aceitar apenas operações de liquidação/pagamento.
No campo “Galax ID" e “Galax HASH”, cole as chaves de integração disponibilizadas anteriormente pelo cel_cash;
Informe o “IP do seu servidor ISPFY” e clique em “Salvar”.
Se por algum motivo seu IP for alterado, será necessário atualizar o webhook, abordaremos isso logo abaixo.
Cuidado com o IP informado, caso não esteja correto, as notificações do gateway não serão recebidas.
Ao salvar, a janela será fechada e a lista de carteiras exibida, no entanto, ainda precisamos configurar o webhook.
-
Clique em “Editar” na carteira que você acabou de criar;
-
Clique em “Atualizar Webhook" para gerar a URL de notificação;
-
Agora basta clicar em “Salvar”.
Para verificar se a URL gerada está funcionando, copie o conteúdo do campo URL gerada para a notificação e cole em seu navegador, se tudo ocorrer bem, a mensagem “Aqui tudo está funcionando bem…” deverá ser exibida.
Após realizar as configurações acima, a integração estará concluída!