Como configurar o Módulo Magento 2 na Vindi Recorrência (versão 1.x)

Sobre a integração

Com esse módulo, a Vindi processará os pagamentos através de uma integração em sua loja Magento.

 

Esta instrução é válida somente para versão M2 do Magento.

 

Esta integração permite vendas avulsas e recorrentes através do Magento 2 de forma transparente. O módulo Vindi segue os padrões máximos de segurança estipulados pela própria PCI, assim, garante ao lojista e ao cliente o máximo de segurança nas transações.

 

Como instalar o módulo Magento 2 VR

Para instalar o módulo da Vindi no magento, basta pedir para o seu time técnico realizar a instalação através dos links abaixo:

https://github.com/vindi/vindi-magento2/tree/1.5.0

https://packagist.org/packages/vindi/vindi-magento2#1.5.0

 

Como configurar o módulo de Vindi Recorrência no Magento 2?

Depois de instalar o módulo de Magento 2, será preciso alguns passos de configuração para realizar suas vendas, que serão explicados a seguir.

 

Primeiramente será necessário entrar no menu da Vindi criado na sua plataforma, e clicar em configurações:

Depois disso, você terá alguns campos que podem ser preenchidos.

 

Modo:

No campo “Modo”, você pode escolher o “Sandbox”(para entender mais sobre o Sandbox) para o ambiente teste, e o de “Produção” para realizar vendas reais. 

 

Chave API:

No campo Chave API, em uma nova aba do seu navegador, acesse o painel de administração da Vindi, crie uma nova chave de API privada acessando Configurações>Chaves de API>Nova chave. Na Vindi tanto o ambiente teste, quanto o de produção, pode ter sua respectiva chave API.

 

Chave do Webhook

Depois desse passo, também é preciso configurar o Webhooks, para isso você precisa copiar a URL que fica disponível na parte debaixo do campo “Chave de Webhook” e em uma nova aba do seu navegador, acesse o painel de administração da Vindi e acesse Configurações>Webhooks>Novo webhook. Cole no campo URL o endereço copiado, selecione os seguintes eventos e clique no botão criar:

1. Assinatura cancelada
2. Assinatura reativada
3. Cobrança rejeitada
4. Fatura cancelada
5. Fatura emitida
6. Fatura paga

 

Novo status do pedido

No campo “Novo status do pedido”, você irá selecionar o status para o qual o pedido irá depois de ser pago e clique em “salvar a configuração”.

 

O módulo foi configurado, e agora será preciso ativar os métodos de pagamentos, através do menu: Lojas/Métodos de Pagamento. 

 

 

Dentro desse menu, você poderá ativar os métodos de pagamentos da Vindi, lembrando que para isso é preciso ter a plataforma configurada e preparada para o método. Para configurar a plataforma para cada método entre em contato com o seu CS, após isso, os métodos aparecerão automaticamente na sua plataforma Magento.

Vindi - Cartão de Crédito

O primeiro passo é marcar "sim" no campo Habilitado, para que o método seja ativado na plataforma. Existem algumas opções de configuração do método como:
. Título - nome ao qual o método será exibido

. Permissão de parcelamento

. Valor máximo de parcelamento

. Valor mínimo de parcelamento

. Transação de verificação 

Vindi - PIX

Assim como no método cartão de crédito, para a ativação do PIX é necessário selecionar a opção "sim" no campo Habilitado.

Também temos a possibilidade de customizar o nome de exibição do método no campo Título e habilitar a solicitação de documento no momento do pagamento.

Configuração Intermediador:

Como configurar o tempo de expiração do QR CODE Pix?

É possível alterar o tempo de expiração do QR CODE do PIX, o valor indicado no campo estará na ordem de minutos, vem definido como padrão o tempo de expiração 30 minutos, mas é possível fazer a edição e converter a quantidade de dias em minutos, como exemplo 6 dias equivalem a 4320 minutos.

1. Acesse o painel Vindi Pagamentos

2. Clique em [Configurações] no menu lateral

3. Clique em [Transação de Vendas]

4. Na penúltima opção [Duração do QRCode (PIX)] - inserir X minutos

Vindi - Boleto bancário

A configuração do boleto é similar às demais,  tendo a possibilidade de habilitar o método através do campo Habilitado e definir o nome de exibição através do campo título.

Pontos de atenção:

• No método de cartão de crédito, deixa a “transação de verificação” como “Não”, caso não tenha a funcionalidade habilitada na plataforma.

 

Configuração Intermediador:

Como configurar os dias para vencer do Boleto?

É possível alterar a quantidade de dias para vencer, logo do boleto, instruções entre outros.

1. Acesse o painel Vindi Pagamentos

2. Clique em [Configurações] no menu lateral

3. Clique em [Transação de Vendas]

4. Terá diversas configurações para o espelho do boleto, como dias para vencer, instruções, logotipo do boleto… que você poderá configurar

 

Como cadastrar produtos por assinatura no magento 2 (versão 1.x):

Magento - Criando Planos e Assinaturas

Dentro do Magento um plano é um bundle que contêm as informações da recorrência. O produto associado a esse bundle é a assinatura.

Por exemplo, se vamos criar um plano mensal para uma assinatura de livros, vamos precisar:

1. Criar o produto Assinatura de Livros (Imagem 1);
2. Criar um plano, um produto do tipo bundle chamado Plano de Assinatura Mensal (Imagem 2);
3. Usar no bundle o conjunto de atributos Vindi Planos e preencher os campos de cobrança recorrente (Imagem 2, Imagem 3);
4. Associar o produto Assinaturas de Livros como um produto filho do bundle (Imagem 4).

No catálogo do Magento irá aparecer o produto Plano de Assinatura Mensal e ao ser adquirido pelo cliente irá gerar um assinatura na Vindi do
produto Assinatura de Livros, com recorrência mensal.

Vale notar que cada plano no Magento está associado a uma assinatura. Será necessário criar um plano para cada assinatura.

Imagem 1: Assinatura de Livros - Produto simples no Magento.

Imagem 2: Plano - Produto bundle no Magento com Attribute Set Vindi Planos

Imagem 3: Dados de recorrência

Imagem 4: Assinatura associada ao plano

 

Criando um Plano no Magento:

 

Um plano é obrigatoriamente um produto do tipo Bundle.

 

No painel do Magento crie um novo produto do tipo bundle.

 

No campo Attribute Set escolha a opção Vindi Planos

 

 

Usando um plano já existente na Vindi:

Nas configurações do plano é possível estar usando as mesmas configurações de recorrência de um plano já criado na Vindi.
Para isso no campo Usar um plano existente na Vindi basta selecionar os planos disponíveis.

Ao fazer isso os demais campos serão removidos e o plano irá assumir todas as configurações registras na Vindi.

Criando um plano novo:

Caso queira criar um novo plano, deixe selecionado no campo Usar um plano existente na Vindi a opção Criar Novo Plano.
Assim os campos de configuração da recorrência estarão visíveis.

 

Configure a Periodicidade e o Tipo de Cobrança conforme os objetivos do plano

Associando uma assinatura no plano:

Na associação dos itens que farão parte do bundle iremos definir os produtos que fazem parte da assinatura.
Essa é uma funcionalidade nativa do Magento. 

 

Concluindo o cadastro de Plano:

Esses são os passos necessários para a criação de um plano que possa ser integrado com a Vindi.
No mais você deve dar um nome para o produto, defini a categoria em que irá aparecer e demais atributos nativos do Magento.
Salve o produto para concluir o cadastro.

Grid de Assinaturas:

No painel do Magento no menu Vindi Assinaturas estão listados todas as assinaturas criadas na conta da Vindi configurada no Magento.

Detalhes da assinatura

Clicando na opção View na coluna Ações será apresentado os detalhes referente aquela assinatura

Todos os dados são consultados diretamente na Vindi e apresentadas no Magento.

Limitações

• Sua conta da Vindi deve estar ativada para realizar vendas. Você pode se cadastrar em: vindi.com.br/cadastro
• Este módulo visa principalmente vendedores e compradores no Brasil. Pois, existem tipos de pagamentos que não estão disponíveis para compradores de outros países.
• Ao utilizar o método de pagamento boleto, o registro deve ser feito através de um arquivo de remessa gerado pela Vindi, que deve ser enviado para o banco. Isso significa que o registro não é feito automaticamente, somente se você tiver uma VAN própria e uma integração via API com a Vindi para subir arquivos de remessa automaticamente.
• Vindi processa as informações de pagamento no checkout padrão do Magento. Sendo assim, as mudanças devem ser ajustadas diretamente no tema do checkout;
• Modificações no checkout podem causar mau funcionamento do módulo Vindi. Você pode obter ajuda e mais informações em atendimento.vindi.com.br.