Plugin Woocommerce Vindi
Este documento serve como um guia completo para lojistas e desenvolvedores que utilizam o plugin da Vindi para Woocommerce, abordando desde a instalação inicial até a gestão do dia-a-dia, incluindo solução de dúvidas frequentes.
1. Como instalar os plugins Woocommerce Vindi?
Acesse o painel administrativo do seu WordPress, vá em Plugins > Adicionar Plugin, pesquise por Vindi Pagamentos, clique em Instalar Agora e, em seguida, em Ativar.
Para mais informações consulte nosso guia completo de instalação presente no Dev Portal.
A Vindi Pagamentos possui um treinamento completo sobre a plataforma?
Sim, nosso passo a passo completo com vídeo aula estão disponíveis no link abaixo:
Onde encontrar suas credenciais (API TOKEN)?
Para que o plugin Shopify Vindi se comunique com sua conta, você precisará da chave de API (Token) de sua conta. Ela fica disponível no menu MINHA CONTA do seu painel Vindi Pagamentos.
Quais os pré-requisitos para usar o plugin Shopify Vindi?
Hospedagem com PHP versão 7.4 ou superior;
WooCommerce: versão 7.0 ou superior;
Brazillian Market on WooCommerce;
WordPress: versão 4.0 ou superior;
Certificado HTTPS instalado em sua loja WordPress;
SSL: Certificado SSL ativo no seu domínio;
Conta ativa na Vindi;
Você deve utilizar o plugin WooCommerce Extra Checkout Fields for Brazil ou outro plugin semelhante, para adicionar os campos abaixo, exclusivos para uso no Brasil, ao checkout:
billing_cpf
billing_cnpj
billing_number
billing_persontype
Obs: sem estes campos o checkout não irá funcionar corretamente.
2. Configurando as Formas de Pagamento Vindi
Para acessar as configurações dos métodos de pagamento Vindi, após ativação, em seu painel administrativo Woocommerce acesse o menu Vindi.
Agora, siga o passo a passo exibido no plugin e já pode iniciar suas vendas!
Passo 1: Credenciais
Selecione o ambiente (Produção ou Sandbox) e informe o Token da Conta e salve as alterações:
Nesta aba você pode também configurar as chaves para processamento de estornos e cancelamentos de forma automática, para saber mais consulte o item 3. Estornos e Cancelamentos.
Passo 2: Métodos de Pagamento
Habilite/Desabilite os métodos desejados e salve as alterações:
É possível ainda realizar configurações avançadas em cada método Vindi, conforme descrito abaixo.
Configurando o cartão de crédito
Aqui você pode personalizar título, descrição, parcelamento e bandeiras aceitas:
Configurando o Boleto
Aqui você pode personalizar título e descrição:
Configuração no painel Vindi
Como configurar os dias para vencer do Boleto?
É possível alterar a quantidade de dias para vencer, logo do boleto, instruções entre outros.
Clique em "Configurações" no menu lateral;
Clique em "Transação de Vendas";
Terá diversas configurações para o espelho do boleto, como dias para vencer, instruções, logotipo do boleto que você poderá configurar.
Configurando o Pix
Aqui você pode personalizar título, descrição, tipo e valor de desconto:
Configuração do Pix no painel Vindi
Como configurar o tempo de expiração do QR Code Pix?
É possível alterar o tempo de expiração do QRCode 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.
Clique em "Configurações" no menu lateral;
Clique em "Transação de Vendas";
Na penúltima opção Duração do QRCode (Pix) - inserir X minutos.
Configurando o Bolepix
Aqui você pode personalizar título, descrição, tipo e valor do desconto:
Configuração no painel Vindi
Como configurar os dias para vencer do Bolepix?
É possível alterar a quantidade de dias para vencer, que o Bolepix terá, ao ser emitido. O valor indicado no campo estará na ordem de dias.
Clique em "Configurações" no menu lateral;
Clique em "Transação de Vendas";
Na última opção "Data limite para pagamento do bolepix" - inserir X dias.
Configurando o Multipayment (pagamento com múltiplos cartões/meios)
Aqui você pode personalizar título, descrição, descontos, métodos de pagamento disponíveis e se deseja salvar os cartões para uso futuro.
Passo 3: Configurações Personalizadas
Em Configurações você pode:
Incluir um prefixo para identificação dos pedidos;
Habilitar e personalizar opções de desconto à vista;
Habilitar a criação de links de pagamentos para pedidos pendentes;
Habilitar compras com um clique;
Permitir o salvamento de cartões para compras futuras;
Ativar os logs.
3. Estornos e Cancelamentos
Estorno manual via Vindi
Você poderá estornar e cancelar transações diretamente por meio do seu Painel Vindi Pagamentos seguindo este passo a passo.
Estorno automático via WooCommerce
Para ativar o cancelamento/reembolso via integração, na aba Credenciais você precisa ativar a opção e informar as chaves Consumer Key e Consumer Secret e clique em salvar:
Logo após, clique em Testar Conexão:
Não possui as chaves? Elas podem ser solicitadas via abertura de chamado pelo formulário disponibilizado na aba Credenciais no painel de configuração do plugin WooCommerce Vindi.
Passo a Passo:
Ative o check “Ativar cancelamento e reembolso”;
Preencha os dados solicitados no formulário;
Aguarde o recebimento das chaves via e-mail da conta;
Salve as chaves e autorize a aplicação.
Como estornar um pedido via WooCommerce
O processo de devolução de dinheiro é feito diretamente pelo painel do WooCommerce:
No painel WordPress acesse o menu WooCommerce > Pedidos;
Selecione o pedido que deseja estornar;
Vá para o resumo do pedido e selecione “Reembolso” para iniciar;
Informe a quantidade de produtos a serem reembolsados. O valor do reembolso será ajustado automaticamente de acordo com os reembolsos dos produtos. Se os níveis de estoque não forem gerenciados, você também pode inserir o valor do Reembolso, sem ajustar a quantidade do produto;
Se as quantidades de itens não forem definidas ao realizar um reembolso, o pedido não será marcado como reembolsado e o e-mail que é enviado informará um “Reembolso parcial”;
Adicione a Razão do reembolso, se desejar. (Nota: O motivo do reembolso ficará visível para o cliente);
Clique no botão Reembolsar.
Para saber mais sobre estornos via WooCommerce acesse o manual da plataforma.
Clique aqui para saber mais sobre o fluxo, prazos e taxas em estornos Vindi.
Como obter a confirmação/recibo de estorno?
Na Vindi chamamos o recibo de estorno de “Carta de Cancelamento”, ela não fica disponível no painel WooCommerce e a Vindi não faz o envio automaticamente via e-mail ao cliente.
Aqui um manual sobre como obter a carta de cancelamento em seu painel Vindi Pagamentos.
4. Conciliação (Pedidos WooCommerce x Transações Vindi)
Como conciliar minhas vendas na Vindi?
Na Vindi a conciliação é feita por meio da conferência do relatório de recebíveis disponível no seu painel Vindi Pagamentos, menu Meus Recebíveis > Relatório de Recebíveis.
O relatório de recebíveis concentra as movimentações de todos os métodos de pagamentos que você utiliza em nossa plataforma, além de informações relativas a entradas e saídas de valores.
Para saber como visualizar e conciliar os valores no relatório de recebíveis clique aqui.
Como conciliar um pedido WooCommerce de forma individual?
Para garantir que um pagamento caiu na Vindi olhando para o pedido na loja:
Verifique se o status do pedido no WooCommerce está como "Concluído";
Consulte nas Notas do Pedido o ID da Transação Vindi. Utilize este ID para buscar a transação no painel da Vindi e confirmar seu status.
Como fazer uma conciliação em massa entre WooCommerce e Vindi?
Para fazer uma conciliação em massa (diversos pedidos), recomendamos a exportação do Relatório de Recebíveis Vindi e do Relatório de Pedidos WooCommerce.
Relatório de Recebíveis Vindi: Menu Meus Recebíveis > Relatório de Recebíveis;
Relatório de Pedidos WooCommerce: Menu WooCommerce > Pedidos, selecione os pedidos que deseja exportar em seguida no campo Ações em massa selecione a opção Exportar como XLSX então clique em Enviar.
Obs: Para a exportação dos pedidos WooCommerce recomendamos a instalação do plugin Advanced Order Export For WooCommerce:
Acesse o painel do WordPress, vá em Plugins > Adicionar novo;
Pesquise por "Advanced Order Export For WooCommerce";
Clique em Instalar agora e depois em Ativar.
O número do pedido salvo na Vindi será o mesmo exibido na coluna Número do pedido do relatório WooCommerce, com o acréscimo do prefixo informado nas Configurações do Plugin Vindi, exemplo: wc-2024.
.
5. Mapeamento de Situação (status) dos Pedidos
Abaixo um mapeamento da situação (status) comuns entre os pedidos WooCommerce e as transações Vindi Pagamentos. Clique aqui para saber mais sobre.
6. Taxas e Prazos de Recebimento
Taxas e Prazos
As taxas e prazos de repasse de sua conta Vindi ficam disponíveis no menu Minha Conta do seu painel Vindi Pagamentos.
Para saber mais sobre como visualizar as suas Taxas e Repasse na Vindi Pagamentos clique aqui.
7. Como aplicar descontos por métodos de pagamento da Vindi
Essa funcionalidade permite que o lojista proporcione descontos em métodos de pagamento específicos da Vindi. Através do painel administrativo do WooCommerce, acessando o plugin da Vindi, é possível configurar descontos percentuais para Pix e Bolepix. Lembrando que essa funcionalidade reflete diretamente no painel da Vindi e que ela só está disponível para métodos de pagamento da Vindi.
Como realizar a configuração de desconto por método de pagamento?
Acesse o painel da sua loja WooCommerce em: menu "WooCommerce > Vindi Pagamentos";
Em seguida, na aba superior clique em "Pagamentos" e em seguida identifique os métodos de pagamento da Vindi (Pix ou Bolepix) e clique em "Gerenciar";
Agora é necessário ativar a funcionalidade marcando a opção "Ativar desconto" e configurar o valor em porcentagem no campo "Valor de Desconto". O campo tipo de desconto é padrão. Após isso clique no botão "Salvar Alterações".
8. Como atualizar os plugins
Para manter seu site seguro e funcionando corretamente é essencial manter todos os plugins atualizados, incluindo o plugin Vindi. Atualizar o plugin Vindi no WordPress é um processo simples e importante para garantir que você tenha acesso aos recursos mais recentes e correções de segurança.
Para atualizar o plugin Vindi, siga estas etapas:
Faça login no painel administrativo do WordPress do seu site;
No menu do painel, vá para Plugins > Installed Plugins (ou Plugins > Plugins Instalados, dependendo do idioma do seu WordPress);
Na página "Installed Plugins", você verá uma lista de todos os plugins instalados no seu site. Procure pelo plugin Vindi na lista;
Se houver uma atualização disponível para o plugin Vindi, você verá uma notificação indicando isso abaixo do nome do plugin. Essa notificação geralmente é destacada em amarelo e mostra o número da versão disponível para atualização;
Para atualizar o plugin Vindi, basta clicar no botão "Update Now" (Atualizar Agora) que aparece abaixo do nome do plugin. O WordPress iniciará o processo de atualização automaticamente;
Após a conclusão da atualização, você verá uma mensagem de confirmação informando que o plugin foi atualizado com sucesso;
Verifique se o site está funcionando corretamente após a atualização. Em geral, as atualizações de plugins não devem causar problemas, mas é sempre uma boa prática verificar se tudo está funcionando conforme o esperado.
Pronto! Você atualizou com sucesso o plugin Vindi no seu site WordPress. Lembre-se de repetir esse processo periodicamente para garantir que todos os seus plugins estejam sempre atualizados e seu site seguro.
9. Dúvidas Frequentes
Como funciona o Antifraude Vindi?
A análise de risco é crucial para a segurança de suas transações, a Vindi conta com sistema antifraude próprio, sem necessidade de contratação de antifraudes externas ou cobranças adicionais.
Ele é acionado em transações via Cartão Crédito onde, após autorização por parte do emissor/adquirente, a Vindi realiza a análise de fraude e então segue para captura ou cancelamento da transação.
Não é possível realizar o desligamento do antifraude Vindi, ele ocorre em 100% das transações processadas via cartão de crédito. Geralmente o retorno do antifraude vem em segundos, mas pode levar minutos ou horas em alguns casos. O prazo máximo para retorno é de até 48 horas úteis.
Para visualizar o status de análise de risco (Aprovado, Reprovado, Em Análise) de um pedido, acesse a página de detalhes do pedido dentro do painel do WooCommerce. A informação é exibida no campo de anotações ou na linha do tempo do pedido.
Como ofertar desconto para pagamento à vista via Pix?
Para configurar acesse a aba Pagamentos no menu Vindi e clique em Configurar;
Depois, marque a opção Ativar desconto e informe o valor percentual no campo Valor do Desconto.
É possível realizar SPLIT (divisão de recebíveis do pagamento)?
Não, atualmente o plugin Vindi para WooCommerce não possui essa funcionalidade.
É possível realizar o pagamento com dois métodos de pagamentos (dois cartões ou Pix + cartão)?
Sim, para isso basta ativar o método de pagamento Multipayment. Com ele o cliente poderá finalizar um pedido utilizando dois cartões, ou uma combinação de métodos como Cartão + Pix, Boleto + Cartão, etc.
O que fazer quando o sistema apresentar a mensagem “Houve um problema ao processar seu pagamento”?
Este erro geralmente possui uma dessas origens:
Credenciais de acesso (e-mail e token): Confira se credenciais foram salvas e se estão corretas (sem dígitos em branco ou faltando algum dígito) e se está usando o ambiente correto (produção ou Sandbox). Confira também se sua conta Vindi está ativa (ela deve estar verificada e o token deve estar visível no menu Minha Conta);
Dados obrigatórios não enviados: Confira se o checkout está obrigando o preenchimento de todos os dados: e-mail, nome completo, documento (CPF/CNPJ), endereço completo e número de telefone;
Dados do cliente inválidos: Visando segurança alguns dados não podem ser utilizados como:
E-mail de consumidor (cliente) igual ao e-mail do vendedor (loja);
Uso de e-mail de testes como “teste@gmail.com”.
Revise estes itens e caso o problema persista, entre em contato com nosso suporte técnico.
Pedidos Cancelados
"Meu cliente diz que pagou, mas o pedido foi cancelado. O que verificar?"
Status Vindi: Verifique o status da transação correspondente no painel Vindi.
Se Pendente: O pagamento pode estar em análise ou o boleto ainda não foi compensado.
Se Rejeitado: A operadora de cartão ou o sistema antifraude reprovou o pagamento.
Antifraude: Se o status for "Rejeitado" ou "Em Análise", verifique se o Antifraude da Vindi bloqueou a transação.
Webhook: Confirme se o Webhook da Vindi está funcionando corretamente para notificar o Shopify.
Outras Situações
10. Segurança
A Vindi é uma empresa segura?
A segurança é prioridade na Vindi.
Conformidade PCI: A Vindi é certificada em conformidade com o PCI DSS (Payment Card Industry Data Security Standard).
Dados de Cartão: Os dados sensíveis do cartão de crédito nunca ficam salvos na sua loja Shopify. Eles são criptografados e enviados diretamente para a Vindi, garantindo a segurança dos dados do seu cliente.