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

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

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

> [!WARNING] 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 notificacoes na conta wide pay|Alterar a URL de Notificações na Conta Wide Pay]].  

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

## Fluxo de Funcionamento  
```mermaid  
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  
```  

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

> [!WARNING] 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
* [[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]]
* [[reenvio gatilhos de comunicacao wide pay|Reenvio Gatilhos de Comunicação Wide Pay]]
* [[alterar a url de notificacoes na conta wide pay|Alterar a URL de Notificações na Conta Wide Pay]]
* [[como solicitar o pix na central do assinante|Como Solicitar o Pix na Central do Assinante]]
* [[logs gateway|Logs Gateway]]
* [[como reprocessar logs gateway|Como Reprocessar Logs Gateway]]
* [[localizar pagamentos - logs gateway|Localizar Pagamentos - Logs Gateway]]
* [[logs de rotinas de cobranca gateway|Logs de Rotinas de Cobrança Gateway]]
* [[como imprimir boleto registrado de gateway importado|Como Imprimir Boleto Registrado de Gateway Importado]]
- [[reenvio gatilhos de comunicacao wide pay|Reenvio Gatilhos de Comunicação Wide Pay]]
* **Manual Gateway Wide Pay**: https://widepay.github.io/api/