Essa integração permite que os clientes finais paguem suas faturas via Central do Assinante, utilizando o cartão de crédito. Os pagamentos são feitos através da recorrência, descontando a mensalidade automaticamente todo mês do cartão do seu cliente.
Caso ainda não tenha conta na Vindi, clique aqui para se cadastrar.
Caso você já tenha uma conta na Vindi, pode abrir um atendimento direto com o setor do SUP - Suporte Carteira de Cobrança - IXC Provedor para a configuração da Carteira de Cobrança por cartão de crédito.
Como configurar as credencias na Vindi
Para realizar a configuração dessa integração em seu IXC Provedor, você irá precisar da sua chave da API (obtida na Vindi) e também um plano de venda (criado na plataforma Vindi), que será utilizado para a criação das assinaturas. Confira abaixo o passo a passo para a criação de ambos.
Como criar a Chave API
Dentro da plataforma Vindi acesse:
- Menu Configurações;
- Chaves de API:
- Clique no botão Nova chave:
- Depois, clique no botão Criar Chave de acesso:
- Copie a chave gerada e guarde essa informação para inserir na carteira de cobrança gerada no IXC.
Como criar o plano de venda Vindi
Para isso, inicie configurando um produto:
O produto sempre precisa ter o valor zerado, pois iremos comunicar o valor da cobrança criada no IXC mensalmente.
- Menu Configurações;
- Produtos:
- Clique no botão Novo Produto:
- Depois, clique no botão Criar Produto:
Feito isso, realize a criação do plano acessando:
- Menu Configurações;
- Planos:
- Clique no botão Novo Plano:
- Insira o produto criado anteriormente e clique no botão Criar Plano:
Após criado o plano, copie o ID gerado e guarde a informação para inserir na carteira de cobrança do IXC:
Como criar a carteira de cobrança no IXC
Criando a carteira
- Acesse o menu Sistema;
- Cadastros;
- Pasta Financeiro;
- Selecione a opção Carteira de cobrança e clique no botão 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 Cartão de Crédito;
- Validar filial na venda: Marcar como Sim se deseja utilizar a carteira apenas para a filial padrão da conta, ou marcar Não se deseja utilizar a carteira em outras filiais;
- Planejamento analítico: Utilize o padrão ID 240 ou cadastre um novo Planejamento analítico
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).
Ao salvar sua nova conta, insira o novo registro a sua carteira de cobrança.
Aba Configurações cartão de crédito
- Gateway: Selecione a opção Vindi;
- Ambiente: Marque Produção;
Credenciamento
- Chave: Insira a Chave API criada na Vindi;
- Plano da Vindi: Insira o ID do Plano criado na Vindi.
Parcelamento
- Máximo de parcelas: Inserir o número de parcelas que deseja conceder aos seus clientes no momento do pagamento, se manter 12, por exemplo, o cliente que pagar via cartão poderá parcelar o valor do boleto em até 12 vezes.
- Juro (% ao mês): Esse parâmetro pode ser utilizado quando no campo acima for utilizado uma quantidade maior que 1. Nesses casos, o cliente que optar pelo parcelamento terá o acréscimo configurado nese campo.
Após realizadas as configurações acima citadas, Salve a sua nova Carteira de Cobrança.
Ao salvar a carteira, o campo Webhook será preenchido com o endereço para onde serão enviadas as notificações. Esse endereço precisará ser configurado também na plataforma da Vindi. Veja como realizar esse processo no próximo tópico dessa página entitulado "Como configurar a URL de notificações (webhook) na Vindi".
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 Recebimento
Para a configuração dessa aba, siga as instruções presentes em: Recebimento para valores divergentes
Como configurar a URL de notificações (webhook) na Vindi
Para inserir o Webhook na Vindi, acesse:
- Menu Configurações;
- Webhook;
- Clique em Novo Webhook e insira a URL que foi gerada no IXC. Depois, marque a opção de Fatura paga e clique em Criar Webhook:
Formas de ativar a recorrência Vindi
Ativar recorrência via Central do Assinante
Para ativar as assinaturas, será necessário preencher no contrato do cliente que irá utilizar a recorrência, a carteira de cobrança da Vindi:
Com isso, ao visualizar o contrato na central do assinante, aparecerá a opção Ativar recorrência ao clicar no ícone de cartão. Clicando nessa opção, o cliente será direcionado a tela de pagamento para preencher os dados do cartão.
Ativar recorrência pela Vindi
Caso o cliente faça a ativação da assinatura pela página de pagamentos da Vindi, será possível vincular manualmente a recorrência no IXC através do caminho abaixo:
- Menu Sistema;
- Cadastros;
- Em Contratos, selecione o contrato do cliente e clique no botão Editar:
- Dentro do contrato, clique no botão Financeiro e selecione a opção Vincular recorrência Vindi:
- Informe o ID da Assinatura e do Perfil de Pagamento (Veja abaixo como obter esses códigos na Vindi):
Essa opção só irá aparecer se o contrato estiver com a carteira de cobrança da Vindi vinculada.
Para o ID da assinatura dentro da Vindi, acesse:
- Acesse o menu Cliente e selecione o cliente desejado:
- Na aba Assinaturas copie o ID e insira no campo Assinatura no IXC:
Para obter o ID do perfil de pagamento, ainda no cliente:
- Selecione a aba Perfis de pagamento;
- Clique no botão de Configurações (ícone de engrenagem):
- Ao Editar, o ID do perfil de pagamento irá constar na URL de acesso. Copie o ID para inserir no campo Perfil de pagamento do IXC:
Como criar as cobranças do cliente na Vindi
Para gerar as cobranças na Vindi, criamos uma rotina de comunicação de cartão. Nela, você irá selecionar a carteira de cobrança da Vindi e um período de vencimento que deseja comunicar. Após a comunicação, as cobranças serão geradas da Vindi.
Veja abaixo como utilizar essa rotina.
- Acesse o menu Configurações;
- Rotinas Financeiro;
- Rotinas Cartão:
- Carteira de Cobrança: Insira a carteira da Vindi;
- Data inicial: Insira a data inicial de vencimento dos boletos que deseja comunicar;
- Data final: Insira a data final de vencimento dos boletos que deseja comunicar.
- Após inseridos os filtros, clique no botão Simular para verificar quais boletos serão trazidos e se for o que realmente deseja comunicar a Vindi, clique em seguida no botão Comunicar Cobranças.