¶
A Iugu é um Gateway de pagamento que possui uma integração automatizada com o IXC, não sendo necessário o envio de arquivos de remessa ou retorno. Essa integração também possibilita a emissão de boletos com o Pix QrCode integrado o mesmo emite boletos com o QR-code integrado.
Para começar a utilizar, será configurada uma Carteira de Cobrança específica, com as credenciais da Iugu. A homologação deve ser feita através do contato com o nosso SUP - Suporte Carteira de Cobrança - IXC Provedor.
Como configurar gateway Iugu
Para configurar o gateway Iugu no seu sistema IXC, é necessário criar um Token dentro da sua conta Iugu e configurar a URL para envio das notificações (gatilhos). Segue abaixo o passo a passo para realizar essa configuração:
Recomendamos que essas configurações e os primeiros testes sejam feitos juntamente ao SUP - Suporte Carteira de Cobrança - IXC Provedor.
- Acesse sua conta Iugu
- No menu lateral, clique no menu Configurações (símbolizado pela engrenagem)
- Desça a tela até as configurações de Desenvolvedor e selecione a opção Integração via API
- Nessa tela, será configurado o Token de comunicação da aplicação. Para gerar um novo Token, clique em Novo
Selecione o tipo Produção e insira uma descrição como por exemplo "IXC Soft", após isso clique em Salvar:
Voltando a tela de Tokens de API você poderá ver suas aplicações e também copiar o Token de produção criado (Cole o código do Token criado no campo Token da carteira criada no IXC):
O Token ficará disponível para copiar somente por 1 hora após a criação.
Precisamos agora configurar a URL para a qual serão enviadas as notificações de pagamento. No menu lateral esquerdo, abaixo da opção Integração via API encontrará o botão Comunicação via Gatilhos. Clique nessa opção e no botão de Novo que irá aparecer no canto superior direito.
Insira a URL gerada na Carteira de Cobrança no campo URL (recomendamos sempre utilizar um domínio com SSL) e no campo Evento marque a opção “Todos”. Após isso clique em salvar e estará pronta a configuração.
Caso deseje utilizar o boleto hibído que traz junto a linha digitável a opção de Pix QrCode, é necessário habilitar na conta o parâmetro de Pix, conforme imagem:
Como criar a Carteira de Cobrança Iugu no IXC
Recomendamos que essas configurações e os primeiros testes sejam feitos juntamente ao SUP - Suporte Carteira de Cobrança - IXC Provedor.
- Acesse o menu Sistema;
- Cadastros;
- Pasta Financeiro;
- 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 financeiro do contrato: Marque como Não para evitar duplicidade de cobrança.
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: Acesse a wiki sobre Como configurar o Planejamento analítico. Lembrando que o planejamento criado deve conter o mesmo nome que colocou na conta.
- Filial: Selecione o ID da filial para a qual será criada esta conta (a filial deve conter o CNPJ igual ao do beneficiário da conta no banco).
Na aba seguinte, chamada Banco:
- Banco: Selecione o ID de acordo com o cadastro nacional de Bancos, no caso da Iugu é: 401 - Iugu Instituição de Pagamentos S. A.;
- Agência: Número da sua agência bancária;
- Dígito verificador da agência: Preencha com o dígito da agência, se houver;
- 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.
;
- Gera PIX: Marque "Sim" para gerar o PIX junto aos boletos, ou "Não" para que não gere:
Para gerar o Call-back é necessário Salvar a carteira antes, a informação de Token pode ser adicionada posteriormente.
Aba Juros/Multas/Desconto
Para a configuração dessa aba, siga as instruções de Juros/Multas/Desconto
Aba Instruções
Para a configuração dessa aba, verifique: Instruções
Aba Impressão
Para a configuração dessa aba, verifique a Wiki Impressão.
Aba Recebimento
Para a configuração dessa aba, siga as instruções presentes em: Recebimento para valores divergentes
Expiração de Faturas Iugu
A Iugu possui uma configuração interna que determina a expiração de boletos 30 dias após o vencimento do mesmo. O status de uma fatura Expirada informa que a cobrança atingiu o tempo limite após o vencimento e expirou, dessa forma, não pode ser paga (similar ao status 'cancelada').
Caso tenha dúvidas referentes a essa configuração, entre em contato com o Suporte Iugu para que possam lhe auxiliar.
Reenviar gatilho de comunicação IUGU (por período)
- Acesse o site da IUGU para Reenviar Gatilho (por período).
- Como mencionado no site e na imagem abaixo, você pode fazer o reenvio com intervalo de 3 em 3 dias no máximo, a data segue o padrão estrangeiro (ANO-MÊS-DIA);
- Passo 1: insira a data inicial da consulta;
- Passo 2: insira a data final da consulta;
- Passo 3: informe o evento de consulta, que será:
- invoice.status_changed
- Passo 4: informe o Token (credencial da api) que está configurado dentro da carteira de cobrança do cliente em seu IXC;
- Paso 5: faça o reenvio dos gatilhos ao clicar no botão "Try it!".
Status API Iugu
Confira o status dos sistemas IUGU: situações atípicas, inatividades e manutenções programadas:
Status API IUGU
Retorne ao menu Gateways
Retorne ao menu Carteira de Cobrança