Central de Ajuda

Leitura de 7 min

Integração Bancária Wide Pay

Este documento apresenta instruções detalhadas sobre a integração e o uso do Gateway Wide Pay. O Gateway melhora o fluxo de cobranças e permite a utilização do boleto híbrido (boleto com Pix), além de possibilitar o registro direto pelo Sistema e o recebimento automático, sem necessidade de gerar ou processar arquivos bancários de remessa e retorno.

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 pode haver 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 que buscam compatibilidade entre a Wide Pay e 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

  • Emissão e registro automático: os boletos híbridos serão gerados e registrados automaticamente pelo Gateway, reduzindo a necessidade de ações manuais.
  • Baixa automática de pagamentos: os pagamentos serão baixados diretamente no Sistema, garantindo mais precisão e economia de tempo.

2. Economia e Eficiência

  • Redução de custos: com tarifas competitivas da Wide Pay, 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 Wide Pay 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 Wide Pay.
  • 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

Homologação

Dados bancários necessários para a integração:

Wide Pay (Gateway)

  • Número da agência com dígito.
  • Número da conta com dígito.
  • Token.
  • Carteira Wide Pay.

Dica!

Caso tenha dúvida sobre algum dos dados bancários, consulte o gerente da sua conta bancária.

Passo a Passo para Obter as Credenciais do Gateway

  1. Acesse sua conta Wide Pay: https://www.widepay.com/conta/acessar.
  2. Faça login com sua conta.
  3. No canto superior direito, clique no menu Configurações (ícone de engrenagem).
  4. No menu lateral esquerdo, clique em Contas.
  5. Clique no botão Adicionar Conta.
  6. Configure a nova conta preenchendo os seguintes dados:
    • Nome: Defina um nome para a conta (identificação da aplicação que gerenciará as cobranças).
    • Gateway: Selecione Não.
    • Ambiente: Escolha a opção Produção.
  7. Clique no botão Adicionar.
  8. Copie as informações Token e Carteira Wide Pay, pois serão necessárias para criar a sua Carteira de Cobrança no Sistema.

Antes de prosseguir, ative o Token:

  1. Acesse a aba Integrações do registro criado.
  2. Na aba API, clique no botão Ativar token.

Agora, configure a URL para o envio das atualizações de status das cobranças. A URL deve seguir a estrutura:

https://ixc.seudominio.com.br/notificacao_widepay.php

Selecione o campo Utilizar esta URL independente da URL definida via API e finalize clicando no botão Editar.

Aviso!

Sempre que o domínio do seu Sistema for alterado, essa URL também precisará ser atualizada na configuração da Conta criada no Wide Pay. Para mais informações, acesse: Alterar a URL de Notificações na Conta Wide Pay.

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 aba Carteira de cobrança, configure os seguintes campos:
    • Descrição: Nome da carteira.
    • Conta: Conta responsável pelo armazenamento dos dados bancários.
    • Tipo de recebimento: Escolha a opção Gateway.
    • Enviar e-mail para cliente ao gerar: Selecione Não.
    • 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 de configuração da conta.
  • Planejamento analítico: Para mais informações, acesse: Contas Contábeis Analíticas.
  • Filial: Selecione o ID da filial para a qual a Conta e a Carteira serão criadas.

Na aba Banco:

  • Banco: Não selecione nenhuma opção.
  • Agência: Número da agência bancária.
  • Dígito verificador da agência: Informe o dígito verificador da agência.
  • Número da conta: Número da conta bancária.
  • Dígito verificador da conta: Informe o dígito verificador da conta.

Configurações Gateway

  • Gateway: Selecione Widepay.

  • Ambiente gateway: Escolha Produção.

  • Token: Insira o Token da conta criada.

  • Envia e-mail Gateways: Selecione Não.

  • Gera Pix: Selecione Sim, se for utilizar Pix no boleto.

  • Enviar cobrança Pix pelo WhatsApp: Ativa a funcionalidade de envio do Template Cobrança Pix, exclusivo da integração com o Opa! Suite. Habilitando este parâmetro, um novo campo ficará visível e obrigatório:

    • Tipo da chave Pix: Selecione na lista a opção que corresponde ao tipo da chave Pix que será utilizada (CPF/CNPJ, E-mail, Telefone ou Chave Aleatória).
    • Chave Pix: Insira a chave Pix principal que está configurada e é utilizada pela sua conta na instituição financeira correspondente a esta carteira de cobrança.

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

Enviar Template Cobrança Pix via WhatsApp com o Opa! Suite

A integração do sistema com a plataforma de mensagens WhatsApp, em parceria com a Meta e OPA! Suite, abre novas possibilidades para a comunicação com seus clientes. Uma dessas funcionalidades é o envio detalhado de informações de cobrança Pix diretamente pelo aplicativo de mensagens WhatsApp. A funcionalidade está disponível em Sistema para carteiras de cobrança do tipo Gateway e Pix.

Quando configurado, seu Sistema estará habilitado para enviar um template otimizado de cobranças Pix ao seu cliente por meio da integração com o Opa! Suite.

Dica!

Para mais detalhes da funcionalidade e configuração, verifique em Enviar Template Cobrança Pix via WhatsApp com o Opa! Suite.

Fluxo de Funcionamento

sequenceDiagram  
    participant S as Sistema  
    participant Gateway as Gateway Wide Pay  
    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

Melhoria!

Otimizado o processamento de logs de liquidação no Sistema.

  • Antes, ao receber um log de pagamento, este permanecia pendente/aguardando por até 3 horas para ser processado, dependendo de uma tarefa executada a nível de servidor.
  • Agora, os logs do Gateway Efí são processados imediatamente após sua chegada ao Sistema, como ocorre com os Gateways Lytex, Asaas e Banco do Brasil, por exemplo.

Ativação

Finalizado!

Depois de concluir todos os passos anteriores, a carteira estará pronta. Agora é possível gerar um boleto teste para validar a baixa da fatura no Sistema.

Aviso!

A Wide Pay limita a emissão mensal a 2000 boletos por padrão. Para aumentar esse limite, entre em contato com o suporte da Wide Pay.

Considerações Finais

A integração entre a Wide Pay e o IXC Provedor representa um avanço importante para 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 GatewayBancario WidePay GatewayDePagamento BoletoHibrido BoletoPix Pix

Leia Também

Visão de gráfico

Páginas relacionadas