Vindi Assinaturas para Shopify
Este guia orienta lojistas e desenvolvedores na configuração do plugin Vindi Assinaturas, para processamento de vendas recorrentes via Shopify utilizando a solução nativa Shopify Subscriptions. O conteúdo abrange desde a instalação inicial até a configuração de planos, temas e testes.
Vantagens do Plugin Vindi
Gestão de Recorrência: Realize cobranças automáticas com cartão de crédito salvo na plataforma Vindi.
Flexibilidade Promocional: Configure descontos para produtos de assinatura ou períodos de teste.
Autonomia do Cliente: Área de assinantes nativa na Shopify, permitindo que o cliente gerencie seus itens, altere a forma de pagamento ou solicite o cancelamento de forma independente.
Pré-requisitos
Shopify
Loja ativa;
Ao menos um produto cadastrado;
Opção de frete configurada.
Vindi
Conta ativa;
Usuário com acesso à plataforma;
Tabela de taxas VP permitida para o Reseller;
Toggle habilitado para uso de antifraude Vindi (vp_profile_risk_code e storage_card_yapay);
Métodos de pagamentos configurados com reseller:
OBS: Como reseller utilizar o token da conta: plugin.shopify@vindi.com.br
Funcionalidades x Planos Shopify
1. Instalação dos Plugins
Quais plugins preciso instalar?
A integração de assinaturas Vindi com Shopify exige a instalação de dois plugins distintos. Instale-os nesta ordem:
Cartão de Crédito - Vindi: responsável pelo processamento dos pagamentos recorrentes via cartão.
Assinaturas - Vindi: gerencia os planos, ciclos de cobrança e a experiência de assinatura do comprador. Instale na sequência após o plugin de cartão.
Passo a passo
Acesse o link dos plugins acima e clique em Instalar:
Sua loja Shopify vai exibir uma tela para confirmar a instalação, clique em Instalar:
Aguarde Shopify finalizar instalação.
Após a instalação, você é direcionado para a tela de configuração de cada plugin.
2. Configuração dos Plugins Vindi
Configurar o plugin de Cartão de Crédito
A configuração de pagamentos é feita no painel administrativo da Shopify, em Configurações › Pagamentos. Localize o método Cartão de Crédito Vindi e clique em Gerenciar.
Passo a passo
Seleciona a opção Habilitado;
Informe o E-mail de sua conta Vindi Pagamentos;
Informe o Token de sua conta Vindi Pagamentos;
Informe a Chave de API (Privada) de sua conta Vindi Recorrência;
Salve as alterações.
Configurar o plugin de Assinaturas
A configuração das assinaturas é feita no painel administrativo da Shopify, no menu Assinaturas Vindi › Configuração ou no menu Apps.
Passo a passo
Informe a Chave Privada Vindi;
Informe a Chave Pública Vindi;
Clique em Conectar.
Cadastrar o Webhook
O Webhook é o canal pelo qual a Vindi comunica à Shopify que uma cobrança foi efetuada — essa comunicação é o que permite a criação automática dos pedidos nos ciclos seguintes, para que o lojista possa faturar e expedir os produtos.
Passo a passo
Na tela de Configurações do plugin de Assinaturas, localize o campo URL de Webhook;
Copie a URL gerada automaticamente pelo plugin;
Acesso o painel da Vindi Recorrência e navegue até a área de Webhooks (Configurações › Webhooks);
Cole a URL copiada no campo URL;
Selecione os seguintes eventos:
Assinatura efetuada;
Assinatura cancelada;
Assinatura reativada;
Cobrança rejeitada;
Fatura emitida;
Fatura paga;
Fatura cancelada.
Salve.
Por que isso é obrigatório? Sem o Webhook cadastrado, a Shopify não recebe notificação das cobranças realizadas pela Vindi, e os pedidos dos ciclos futuros não são criados automaticamente.
Criar planos de assinatura
Os planos definem com que frequência o cliente será cobrado e qual desconto receberá em relação à compra avulsa. No painel do plugin de Assinaturas, clique em Criar Plano e preencha:
Nome do plano: escolha um nome claro para o comprador, por exemplo: "Assinatura Mensal", "Assinatura Trimestral com 10% de desconto".
Produtos: Clique em Selecionar Produtos, a Shopify irá exibir uma tela para seleção dos produtos e variantes que deverão ser ofertados para o plano de assinatura atual.
Frequência de entrega: escolha entre as opções existentes (diário, semanal, mensal, bimestral, trimestral, semestral, anual)
Desconto (opcional): defina um desconto para diferenciar a assinatura da compra avulsa. O desconto é permitido apenas em lojas Shopify Plus e pode ser por valor percentual (ex.: 10%) ou por valor final (ex.: R$ 45,00 em vez de R$ 50,00).
Personalização do Tema
A última etapa é adicionar o Widget (funcionalidade) ao tema da loja, na página do produto, para que a Shopify exiba as opções de planos de assinatura ou compra avulsa. Sem ele, o comprador não vê as opções de assinatura durante a navegação.
No painel do plugin de Assinaturas, menu Configurações, localize a seção de Widget.
Clique no botão "Adicionar ao Tema". O plugin integra o Widget automaticamente ao tema ativo da loja.
Após a adição, acesse uma página de produto em sua loja para confirmar que os planos estão sendo exibidos corretamente.
O que fazer caso o botão não adicione automaticamente? A funcionalidade é compatível com a maioria dos temas padrões Shopify, todavia, por se tratar de layout, algumas lojas podem ter comportamentos diferentes. Se nada acontecer ao clicar no botão, siga as instruções abaixo:
Acesse o editor de tema de sua loja Shopify (Canais de Vendas > Editar Tema):
No topo superior será exibido um menu para navegar entre as páginas, clique e selecione Produtos > Produto Padrão:
No menu superior esquerdo, clique no último ícone: Incorporações de Apps:
Ative o Botões Vindi:
Retorno ao menu Sessões no primeiro ícone do canto superior esquerdo:
Por fim, arraste o bloco Planos Vindi para uma posição acima do Botões de Compra:
Ocultar os botões de compra nativos da Shopify
Ainda no editor de tema Shopify, precisamos esconder/desativar os botões "Comprar agora" e "Adicionar ao carrinho" nativos da Shopify. Para isso, encontre a seção Botões de compra dentro do bloco de informações do produto e clique ícone “olho” para desativar:
Atenção: se os botões nativos não forem ocultados, o comprador poderá finalizar uma compra avulsa em vez de assinar, gerando divergência entre o pedido na Shopify e o esperado na Vindi Recorrência.
Definir permissões do comprador
Por padrão, o comprador pode precisar de suporte para realizar qualquer alteração na assinatura. Habilitar permissões de autoatendimento reduz chamados e melhora a experiência do cliente.
No painel do plugin, acesse a seção de Assinaturas — permissões do comprador e habilite a opção e salve as permissões.
Teste de Primeira Assinatura
Antes de abrir a loja para os clientes, realize um teste completo do fluxo de assinatura para garantir que todos os componentes estão funcionando corretamente.
Acesse a loja como um cliente (de preferência em uma janela anônima ou com um usuário diferente do administrador).
Navegue até a página de um produto com plano de assinatura configurado. Verifique se o Widget está exibindo as opções de plano corretamente.
Selecione um plano de assinatura e confirme que o desconto está sendo exibido de forma destacada em relação ao preço avulso.
Finalize o checkout com um cartão de teste. Confirme que os dados de pagamento foram aceitos e que a tela de confirmação foi exibida.
Verificar o fluxo completo nos painéis
Após finalizar o teste de assinatura, confirme o resultado em três pontos:
Painel Shopify — Pedidos: o pedido deve ter sido criado com o status Pago. Isso confirma que o Webhook funcionou e a Shopify recebeu a confirmação da cobrança.
Painel Vindi Recorrência — Assinaturas: a assinatura deve estar criada, com o primeiro ciclo registrado e com status de cobrança aprovado.
Aplicou desconto? Confira nos detalhes do pedido (Shopify) e da fatura (Vindi Recorrência) se o valor cobrado corresponde ao preço do plano com desconto, e não ao preço avulso.
Se o pedido não aparecer na Shopify? Verifique se o Webhook foi cadastrado corretamente no painel da Vindi Recorrência (passo 2.3). Sem o Webhook ativo, a Shopify não recebe a confirmação e o pedido não é criado.
Dúvidas Frequentes
Como acessar a Vindi Pagamentos?
Como acessar a Vindi Recorrência?
Link painel Vindi Recorrência.
Como obter o Token da conta Vindi Pagamentos?
Menu MINHA CONTA, campo TOKEN.
Como obter as Chaves de API (Privada/Pública) de sua conta Vindi Recorrência?
Menu Configurações > Chaves de API. Criar uma chave pública e uma chave privada. Após criação armazenar as chaves em local seguro, elas são exibidas apenas uma única vez, não sendo possível consultar posteriormente, tendo então que remover e criar novas.