Vindi Pagamentos

1. Como instalar os plugins Shopify Vindi?

Cada método de pagamento Vindi (PIX, Boleto, Bolepix e Cartão de Crédito) possui um plugin próprio para instalação. Acesse cada um dos links, conforme métodos desejados, e prossiga com a instalação:

Após instalar, habilite o método de pagamento, informe e-mail e token de sua conta Vindi Pagamentos e salve.

Por fim, ative os métodos que deseja utilizar e salve.

Pronto! O plugin está pronto para realizar sua primeira venda.

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:

Treinamento Vindi Pagamentos

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?

Para que sua loja Shopify atenda corretamente ao requisitos do plugins, duas configurações iniciais devem ser feitas, para isso, acesse o menu Configurações > Checkout:

Identificação por e-mail:

Em Forma de contato do cliente, altere para a opção E-mail:

Número de telefone como obrigatório:

Em Informações do cliente altere o campo Telefone do endereço de entrega para Obrigatório:

2. Configurando as Formas de Pagamento Vindi

Para acessar as configurações dos métodos de pagamento Vindi, em seu painel administrativo Shopify acesse o menu Configurações > Pagamentos.

Também é possível acessar as configurações pesquisando por Vindi e filtrando por Apps no menu de pesquisa.

Configurando o método Cartão de Crédito - Vindi

Ao acessar as opções de Pagamento, no método Cartão de Crédito - Vindi clique no botão Gerenciar.

Será exibida uma tela de configuração onde você pode habilitar/desabilitar as bandeiras que devem ser aceitas pelo método Vindi.

Você também pode ativar/desativar o modo de testes da Shopify (este modo é utilizado para validar o fluxo de um pedido sem necessidade de processar seu pagamento real).

Para acessar as configurações do plugin, no menu de ações clique em Gerenciar.

O método deve estar habilitado e você deve informar o e-mail e token de sua conta Vindi Pagamentos:

Caso você queira apenas testar o plugin e ver como o fluxo do pedido funciona utilize e-mail e token da Vindi que já vem preenchido no plugin e deixe a opção Sandbox ativa.

Você pode usar seu próprio ambiente Sandbox também, caso possua, basta alterar e-mail e token.

Configurando Juros no Parcelamento

No plugin de Cartão de Crédito da Vindi é possível calcular juros nas parcelas de duas formas: com juros fixos ou conforme configuração de juros da conta Vindi Pagamentos.

Para utilizar a opção de juros fixos, marque o checkbox "Usar Juros Fixos" e no campo "Taxa de Juros" informe o valor percentual que deseja, ou deixe zerado para não calcular juros.

Se você não marcar esta opção, o sistema irá calcular conforme tabela de juros padrão baseado nas taxas do Mastercard de sua conta Vindi. Mas para isto, é necessário que você clique no botão Atualizar Taxas de Juros.

Importante:

Caso você altere as configurações de juros/parcelamento em sua conta Vindi, ou negocie novas taxas com time Comercial, é necessário atualizar a tabela de juros padrão em sua conta Shopify novamente.
O valor com juros calculado será exibido no campo de parcelamento dentro do checkout Shopify. Embora a Shopify não exiba ele no campo Total este é o valor que será cobrado do cliente.

Configurando o método Pix - Vindi

Ao acessar as opções de Pagamento, em Formas de pagamento adicionais clique na opção Pix - Vindi.

No menu Mais Ações, clique em Gerenciar:

O método deve estar habilitado e você deve informar o e-mail e token de sua conta Vindi Pagamentos.

Recomendamos utilizar a opção Página de Confirmação (Recomendado) no campo Modo de Exibição do PIX, assim os clientes terão o QRCode e Chave Copia e Cola exibidas dentro do checkout, sem necessidade de redirecionamento.

Personalização da Página Pix

A Shopify não permite a exibição de dados como o QR Code e Chave Copia e Cola na tela de confirmação de pagamento.

Quando um pedido for finalizado com o método de pagamento PIX o usuário será redirecionado para um ambiente seguro Vindi onde os dados para pagamento serão exibidos.

Você pode personalizar o logo, descrição, cores e CSS da página.

Configurando o método Boleto - Vindi

Ao acessar as opções de Pagamento, em Formas de pagamento adicionais clique na opção Boleto - Vindi.

No menu Mais Ações, clique em Gerenciar.

O método deve estar habilitado e você deve informar o e-mail e token de sua conta Vindi Pagamentos.

Configurando o método Bolepix - Vindi

Ao acessar as opções de Pagamento, em Formas de pagamento adicionais clique na opção Bolepix - Vindi.

No menu Mais Ações, clique em Gerenciar.

O método deve estar habilitado e você deve informar o e-mail e token de sua conta Vindi Pagamentos.

O que fazer quando algum método não for exibido?

Apenas métodos de pagamento ativos são exibidos na tela de configuração de pagamentos da Shopify. Caso algum método desejado não esteja sendo exibido, siga os passos abaixo.

Ao acessar as opções de Pagamento, clique em Adicionar forma de pagamento, depois em Busca por provedor, então digite Vindi. Depois selecione a opção desejada.

Ative e salve a opção.

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 Shopify

Para ativar o cancelamento/reembolso via integração você precisa informar as chaves Consumer Key e Consumer Secret depois clicar em Autorizar Aplicaçã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 Shopify Vindi.

Passo a Passo:

Ative o check “Habilitar Fluxo de Cancelamento/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 Shopify

O processo de devolução de dinheiro é feito diretamente pelo painel do Shopify:

Acesse o pedido que deseja estornar no painel do Shopify;
Selecione a opção "Reembolsar";
Insira o valor a ser reembolsado (total ou parcial) e salve.

O plugin Vindi enviará o comando de estorno para a plataforma Vindi, que processará a devolução.

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 Shopify 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 Shopify 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 Shopify de forma individual?

Para garantir que um pagamento caiu na Vindi olhando para o pedido na loja:

Verifique se o status do pedido no Shopify está como "Pago";
Consulte o campo de detalhes do pagamento, que deve conter o Número do Pedido Vindi. Utilize este ID para buscar a transação no painel da Vindi e confirmar.

Como fazer uma conciliação em massa entre Shopify 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 Shopify.

Relatório de Recebíveis Vindi: Menu Meus Recebíveis > Relatório de Recebíveis.
Relatório de Pedidos Shopify: Menu Pedidos, campo Exportar disponível no canto superior direito.

No relatório de pedidos Shopify o Número do Pedido salvo na Vindi fica disponível na coluna referente aos Payment Reference. Após exportados faça a conciliação por meio destas informações.

5. Mapeamento de Situação (status) dos Pedidos

Abaixo um mapeamento da situação (status) comuns entre os pedidos Shopify 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. 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 externos 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 Shopify. A informação é exibida no campo de anotações ou na linha do tempo do pedido.

Como ofertar desconto para pagamento à vista (Pix/ Boleto)?

Atualmente o plugin Shopify Vindi não possui essa funcionalidade.

É possível realizar SPLIT (divisão de recebíveis do pagamento)?

Não, atualmente a Shopify não possui suporte nativo à esta atividade, portanto a Vindi não possui essa funcionalidade.

É possível realizar o pagamento com dois métodos de pagamentos (dois cartões ou PIX + cartão)?

Não, atualmente a Shopify não possui suporte nativo à esta atividade, portanto a Vindi não possui essa funcionalidade.

Como contabilizar as conversões para Pix e Boleto (tagueamento do checkout)?

Atualmente apenas o Pix conta com integração sem redirecionamento, mantendo o usuário dentro do checkout Shopify.

A Shopify não possui suporte nativo para exibição de dados de pagamento na tela de agradecimento (Thank You Page/Success) após finalização de um pedido. Para contornar essa situação, quando um pedido via Boleto ou Bolepix é finalizado via plugin Shopify Vindi o usuário (cliente) é redirecionado para um ambiente seguro Vindi, onde o QRCode, Chave Copia e Cola e/ou Linha Digitável serão exibidas. Este ambiente possui uma automação que valida quando o pedido for pago, redirecionando novamente o usuário (cliente) para a tela de agradecimento (Thank You Page/Success) Shopify.

O redirecionamento no processo de pagamento impacta portanto o tagueamento da conversão para Boleto ou Bolepix

Porque o valor cobrado do cliente pela Vindi é diferente do valor exibido no checkout Shopify?

A Shopify não possui suporte nativo para alteração do TOTAL do pedido no resumo do checkout Shopify.

Quando uma venda via Cartão de Crédito for realizada, de forma parcelada, onde a conta Vindi Pagamentos e Shopify estejam configuradas para calcular juros no parcelamento, o valor real cobrado, com juros, só será exibido no campo de seleção de parcelamento.

O total da compra exibido no checkout Shopify não contempla os juros de parcelamento, por isso a divergência visual. Todavia o valor cobrado do cliente pela Vindi está correto, conforme regras de parcelamento configuradas.

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 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: email, 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.

O que fazer quando o sistema apresentar a mensagem “Application Error”

Este erro está relacionado à alguma falha de comunicação, geralmente devido à erros durante a instalação do plugin. Quando ocorrer recomendamos desinstalar, reinstalar e configurar novamente o plugin.

Se o problema persistir entre em contato com nosso suporte técnico.

O que fazer quando a opção Pix ou Boleto funcionam mas Cartão de Crédito apresentar erro?

Primeiro, confira se as credenciais estão corretas.

Não sendo credencial, geralmente este erro está relacionado à falha de comunicação, devido à erros durante a instalação do plugin. Quando ocorrer, recomendamos desinstalar, reinstalar e configurar novamente o plugin.