Como configurar o novo módulo do Magento 2 da Vindi

Aprenda abaixo como instalar o novo módulo do Magento 2 da Vindi, com Cartão de Crédito, Boleto e Pix.

Descrição

Módulo disponível em português e inglês, compatível com a versão 2.3.5+ do Adobe Commerce.

 

O módulo utiliza a API da Vindi para a geração de pagamentos com:  

- Cartão de Crédito;

- Boleto;

- PIX.

Instalação

Versões Compatíveis:

  •  Magento Superior a versão 2.3.5.

Pré requisito:

  • Requer a que o PHP esteja no mínimo na versão 7.1+.

 

Instalação via composer

  • Vá até o diretório raíz do Magento e adicione o módulo "composer require vindi/magento2-payments";

  • Atualize os módulos disponíveis do Magento e crie as dependências entre os módulos e os arquivos estáticos como CSS e JS, é preciso dos 3 comandos.

php bin/magento setup:upgrade

bin/magento setup:di:compile

php bin/magento setup:static-content:deploy pt_BR en_US

 

Instalação manual

  • Faça Download do módulo vindi-magento2-payments  e coloque na pasta "app/code/Vindi/VP";

  • Atualize os módulos disponíveis do Magento, crie as dependências entre os módulos e os arquivos estáticos como CSS e JS, é preciso dos 3 comandos.

php bin/magento setup:upgrade

bin/magento setup:di:compile

php bin/magento setup:static-content:deploy pt_BR en_US

Configuração

Acesse no Painel Administrativo do Magento. No menu lateral clique em "Store (lojas)", na sequência clique em "Configuration (configuração)", no sub-menu "Sales (vendas)" clique em "Payment Methods (métodos de pagamento)". Será carregada a tela para configurar os meios de pagamentos do site.

Como habilitar a Vindi Pagamentos no seu e-commerce Magento 2

No primeiro bloco de informação, estão as informações de configuração da sua conta Yapay.

  • E-mail:  E-mail utilizado para criação da conta Yapay.

  • Token

    •  Chave de integração da conta Yapay. Os tokens de produção e sandbox são distintos.

    •  O token da conta é gerado após o cadastro da conta e fica disponível no menu “minha conta”.

Acesso Produção

Acesso a Sandbox

Como criar Sandbox

  • Ambiente

    •  Se habilitado, a transação será feita no ambiente de testes (sandbox) da Vindi.

  • Mostrar Informações de Pagamento na Página de Sucesso

    • Essa configuração é caso sua loja não mostre as informações de pagamento na página de sucesso,  se sua loja mostra as informações de pagamento na página de sucesso, NÃO habilite esta funcionalidade

  • Habilitar Log de Requisições

    •  Se habilitado, é realizado a guarda das requisições feitas pelo módulo e respostas recebidas, pode ser acessado no menu de “Sales” (vendas).

  • Atributos de endereço

    •  Configuração das linhas de endereço.

Configurando os meios de pagamentos

Cartão de Crédito

  • Habilitado: Se vai aparecer ou não no checkout.

  • Título: O nome do método que vai aparecer no checkout.

  • Tipo do Cartão de Crédito: Quais as bandeiras aceitas

  • Novo status do pedido: Status após a finalização da compra

  • Status de Pedidos Pagos: Status depois que o pedido é pago

  • Status de Pedidos Virtuais Pagos: Status após a finalização da compra quando são produtos sem entrega.

  • Ordenação: Ordem que vai aparecer o método, se não cadastrado, será incluído com base nas últimas atualizações do método. 

  • Pagamento de Países Aceitos: Quais países esse método poderá ser utilizado.

  • Valor mínimo do pedido: Valor mínimo para finalizar um pedido com esse método.

  • Valor máximo do pedido: Valor máximo para finalizar um pedido com esse método.

 

Pix

Configuração Magento:

  • Habilitado: Se vai aparecer ou não no checkout.

  • Título: O nome do método que vai aparecer no checkout.

  • Instruções de Checkout: Instruções a serem mostradas na página de checkout para o método, pode ser HTML.

  • Novo status do pedido: Status após a finalização da compra

  • Status de Pedidos Pagos: Status depois que o pedido é pago

  • Status de Pedidos Virtuais Pagos: Status após a finalização da compra quando são produtos sem entrega.

  • Ordenação: Ordem que vai aparecer o método, se não cadastrado, será incluído com base nas últimas atualizações do método. 

  • Pagamento de Países Aceitos: Quais países esse método poderá ser utilizado.

  • Valor mínimo do pedido: Valor mínimo para finalizar um pedido com esse método.

  • Valor máximo do pedido: Valor máximo para finalizar um pedido com esse método.

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:

Boleto Bancário

  • Habilitado: Se vai aparecer ou não no checkout.

  • Título: O nome do método que vai aparecer no checkout.

  • Instruções de Checkout: Instruções a serem mostradas na página de checkout para o método, pode ser HTML.

  • Novo status do pedido: Status após a finalização da compra

  • Status de Pedidos Pagos: Status depois que o pedido é pago

  • Status de Pedidos Virtuais Pagos: Status após a finalização da compra quando são produtos sem entrega.

  • Ordenação: Ordem que vai aparecer o método, se não cadastrado, será incluido com base nas últimas atualizações do método. 

  • Pagamento de Países Aceitos: Quais países esse método poderá ser utilizado.

  • Valor mínimo do pedido: Valor mínimo para finalizar um pedido com esse método.

  • Valor máximo do pedido: Valor máximo para finalizar um pedido com esse método.

 

Configuração Intermediador:

Como configurar os dias para vencer do Bolepix?

É 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 poderá configurar.

Cancelamento dos pedidos

Precisa ser feito dentro da plataforma de Vindi pagamentos, indo em “minhas vendas”, acessando a transação em questão, e selecionando “cancelar transação”, conforme exemplo abaixo:

Depois disso, será gerado um callback, para cancelar o pedido no site.