Neste artigo, vamos apresentar as possíveis razões pelas quais a integração com a Shopify ou o seu checkout podem não funcionar corretamente, e mostrar como corrigir cada situação. Recomendamos a leitura até o final, verificando todos os pontos mencionados.

Se você precisa de ajuda para integrar o Checkout Transparente da Yampi com a sua loja Shopify, siga o passo a passo do tutorial Como configurar o Checkout da Yampi na Shopify?.

Se a instalação apresentar erros, verifique os pontos abaixo:

A integração acontece com o domínio marcado como "Principal" no seu painel da Shopify. Essa é uma dúvida comum, porque a Shopify permite alterar a URL e também o domínio principal da loja.

Para identificar o domínio correto, acesse a sua conta Shopify:

Passo 1 — Acesse "Configurações" → "Domínios".

Passo 2 — Identifique o domínio marcado com a tag "Principal". Esse mesmo domínio aparece no canto esquerdo, abaixo do nome da sua loja.

Ao finalizar a instalação, apareceu uma mensagem em vermelho no canto esquerdo da tela, como no print abaixo? Isso indica que o Client ID, o Secret, ou ambos, estão incorretos. Quando as chaves inseridas na Yampi não correspondem às configuradas no app dentro do Dev Dashboard, o erro aparece.

Como corrigir?

Passo 1 — Acesse o app no Dev Dashboard da Shopify.

Passo 2 — Clique em "Settings".

Passo 3 — Copie as duas credenciais novamente e cole na Yampi.

Tentou conectar a sua loja Shopify na Yampi e apareceu o aviso de que a URL já está em uso?

Esse erro acontece quando existe outro painel na Yampi com a mesma integração ou URL. Como cada painel permite apenas uma integração Shopify, o sistema não aceita o cadastro novamente.

Para resolver, acesse o painel da Yampi onde essa URL está cadastrada e desinstale a integração, seguindo o artigo Como desinstalar o Checkout da Yampi no Shopify?. Se você não tem mais acesso a essa conta, nosso time pode ajudar: abra um chamado clicando no ícone de atendimento dentro do seu painel da Yampi.

Finalizou a integração, mas na hora de salvar as informações apareceu um erro no canto esquerdo da tela, como no print abaixo? Isso indica que, na etapa de configuração dos escopos de acesso, alguma permissão foi inserida de forma incorreta ou está faltando.

Como corrigir?

Passo 1 — Acesse o Dev Dashboard e abra o aplicativo que está instalando na Yampi.

Passo 2 — Clique em "Versions" e depois em "Create a Version".

Passo 3 — Em "Access", configure os escopos. Se houver alguma informação preenchida, apague e insira o trecho abaixo:

Passo 4 — Clique em "Release" e depois novamente em "Release".

Passo 5 — Clique em "Home".

Passo 6 — Siga as instruções do nosso tutorial de instalação a partir do tópico Passo 3 - Configurando a "Distribuição" do app (Distribution).

Esse erro acontece quando você gera o link no painel Partners da Shopify e retorna ao Dev Dashboard para finalizar a instalação clicando no botão "Instalar".

Esse fluxo não funciona. Depois de gerar o link, copie e cole no navegador para prosseguir com a instalação.

Siga as instruções do nosso tutorial a partir do tópico Passo 3 - Configurando a "Distribuição" do app (Distribution).

Durante a instalação do app, dois status podem aparecer e impedir a conclusão: "loja inativa" e "conexão recusada". Cada um tem uma causa específica e um caminho de solução.

Esse status aparece quando a instalação é iniciada por um e-mail diferente do e-mail proprietário da conta da loja Shopify.

Como corrigir?

Passo 1 — Confirme com qual e-mail você está logado na Shopify.

Passo 2 — Acesse com o e-mail proprietário da loja, ou seja, o mesmo que é dono da conta Shopify.

Passo 3 — Reinicie a instalação a partir desse acesso.

Esse status costuma estar relacionado à configuração incorreta do domínio, ou ao uso indevido do parâmetro de exibição embed=true.

Passo 1 — Confira se o domínio marcado como "Principal" na Shopify está correto, conforme mostramos no tópico Confira se a URL da loja está correta.

Passo 2 — Verifique se o parâmetro embed=true não está aplicado de forma indevida na URL de instalação.

Passo 3 — No Dev Dashboard, abra o app que você criou e confirme se existe uma versão ativa. Sem uma versão liberada em "Versions", a instalação não é concluída.

Passo 4 — Reinicie a instalação com a URL correta, seguindo o tutorial de instalação do Checkout da Yampi na Shopify.

Com a integração concluída, revise alguns pontos importantes para o funcionamento adequado do seu checkout. Se algo não estiver funcionando conforme o esperado, verifique os tópicos abaixo:

A inclusão do domínio não é obrigatória, mas se você utiliza domínio próprio na Shopify, é necessário cadastrá-lo também no painel da Yampi. A falta do domínio pode gerar conflitos na integração e problemas no redirecionamento do Checkout.

Para configurar o seu domínio:

Passo 1 — Acesse "Configurações" → "Domínios".

Passo 2 — Clique em "+ Vincular novo domínio".

Depois do cadastro, o domínio leva até 30 minutos para propagar. Quando a propagação estiver concluída, o domínio da sua loja também fica disponível no seu Checkout Yampi.

Sem uma afiliação de pagamento cadastrada, o checkout da sua loja não funciona.

Para cadastrar uma afiliação:

Se você veio de outro checkout ou realizou testes com ele, podem ter ficado resquícios de código no seu tema. Quando há resquícios do snippet de outro checkout no tema da Shopify, é preciso remover esse código para o Checkout da Yampi funcionar corretamente. Esses códigos podem causar conflito e afetar o funcionamento do seu checkout.

Ao clicar em "Adicionar ao carrinho" ou "Finalizar compra", observe o comportamento da loja:

É necessário remover esse código para o nosso checkout ativar. Temos um vídeo com o passo a passo da remoção: assista ao tutorial de remoção do código.

O botão "Compre já" (botão dinâmico de compra) e o carrinho AJAX (carrinho lateral, ou mini-cart) dos temas da Shopify não são nativamente compatíveis com checkouts de terceiros, porque o botão de finalização utiliza o redirecionamento padrão para o checkout nativo da Shopify.

Por isso, recomendamos:

O carrinho AJAX é uma janela lateral que abre quando o produto é adicionado ao carrinho. Ele é um recurso próprio da Shopify, e basta desativá-lo para que o cliente passe pela página de carrinho em vez do pop-up.

Em cada tema, essa configuração fica em um local específico. Se o seu tema não estiver na lista abaixo, recomendamos contatar os desenvolvedores do tema para indicarem o caminho exato.

▶️ Clique na seta ao lado do nome de cada tema para visualizar a explicação detalhada.

Se os pedidos importados da Shopify chegam ao seu painel da Yampi sem a marcação de "E-mail Marketing", o consentimento do cliente não está sendo registrado na origem. Esse aceite depende de duas configurações na Shopify: a exibição da opção de marketing no checkout e a forma como a assinatura de e-mail é confirmada.

Como corrigir?

Passo 1 — Na Shopify, acesse "Configurações" → "Checkout".

Passo 2 — Na área de marketing, ative a opção que exibe o aceite de e-mail marketing no checkout, para que o cliente autorize o recebimento de comunicações.

Passo 3 — Ainda na Shopify, acesse "Configurações" → "Notificações" (notificações do cliente).

Passo 4 — Localize a opção de "dupla confirmação" (double opt-in) da assinatura de e-mail e desative-a. Com a dupla confirmação ativa, o aceite é registrado apenas depois de o cliente confirmar em um segundo e-mail, e por isso o pedido chega sem a marcação.

Com o aceite registrado corretamente, você utiliza essa base em suas campanhas, inclusive nas integrações de e-mail marketing disponíveis na Yampi, como Klaviyo, Mailchimp, Active Campaign e RD Station.

Se você verificou todos esses pontos e o checkout continua sem funcionar, pode tratar-se de uma incompatibilidade no tema, já que existem milhares de possibilidades de personalização na Shopify. Nesse caso, contate o nosso suporte para verificarmos essa questão com você.

▶️ Clique na seta para visualizar o conteúdo.

Em caso de dúvidas, clique no balãozinho de atendimento em seu painel ou nos encaminhe pelo e-mail [email protected] 😉