Neste artigo, vamos explorar algumas das possíveis razões pelas quais o seu checkout pode não estar funcionando corretamente e mostrar como você pode corrigir. Pedimos que leia até o final e que verifique todos os ponto mencionados, combinado?

Nesse artigo, vamos abordar os seguintes tópicos:

Por que a integração entre o checkout da Yampi e a minha loja Shopify dá erro?
Já integrei a Shopify. Por que meu checkout não está funcionando?
Dúvidas frequentes

Por que a integração entre o checkout da Yampi e a minha loja Shopify dá erro?

Se você precisa de ajuda para integrar o Checkout Yampi com a sua loja Shopify, siga o passo a passo deste tutorial. Caso tiver dúvidas ou a sua integração não funcionar, ou apresentar erros, verifique os seguintes pontos:

1. Confira se a URL da loja está correta.

Integramos com o domínio marcado como "Principal" em seu painel da Shopify. Essa pode ser uma dúvida bastante comum, devido a uma atualização da Shopify que permite a modificação da URL e também do domínio principal.

Para encontrar e identificar o domínio correto a ser utilizado, acesse na sua conta Shopify:

Passo 1 - Acesse: "Configurações" → "Domínios"

Passo 2 - Identifique o domínio que estiver marcado com a tag "Principal" ao lado, assim como mostramos no print abaixo. Esse mesmo domínio estará no canto esquerdo abaixo do nome da sua loja:

2. App não instalado. Verifique os dados de Client ID e Secret

Ao finalizar a instalação se deparou com essa mensagem destacada em vermelho, no canto esquerdo da tela? Assim como mostramos no print abaixo?

Então significa que ou o Client ID, ou Secret, ou ambos estão incorretos. Se as chaves inseridas na Yampi não corresponderem às mesmas que estão configuradas no app dentro do painel de Dev Dashboard, esse erro será apresentado.

Como corrigir?

Acesse o app no Dev Dashboard e clique em "Settings". Copie e cole novamente as duas credenciais e cole na Yampi.

⚠️ Certifique-se de não ter nenhum caractere incorreto, nem espaços em branco antes e/ou depois das chaves.

3. URL em uso

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

Esse erro acontece quando há outro painel na Yampi com a mesma integração/URL ; e como só pode ter uma integração Shopify por painel, então o sistema não permite que seja cadastrada novamente.

Para resolver, acesse o painel da Yampi onde essa URL está cadastrada e desinstale a integração. Se não tiver mais acesso a essa conta, nosso time pode te ajudar! Basta abrir um chamado clicando no ícone de atendimento dentro do seu painel da Yampi.

4. App não instalado. Verifique as permissões no escopo do app na Shopify

Finalizou a integração, mas na hora de salvar as informações deu esse erro no canto esquerdo, exatamente como no print abaixo?

Isso significa que, na etapa da configuração dos escopos de acesso, alguma permissão foi inserida erroneamente, ou alguma está faltando.

Como corrigir?

Passo 1 - Acesse seu painel 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" é onde você configura os escopos, então é nessa etapa que precisará corrigir. Se houver alguma informação ali, apague e insira o trecho abaixo:

write_orders, read_orders, write_products, read_products, write_themes, read_themes, read_discounts, read_price_rules

Passo 4 - Feito isso, 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, seguindo a partir desse tópico: Passo 3 - Configurando a "Distribuição" do app (Distribution).

5. O link de instalação para este app é inválido

Este erro acontece quando você vai até a etapa de gerar o link em seu painel Partners Shopify e retorna para o Dev Dashboard para finalizar a instalação, clicando no botão "Instalar".

Está incorreto esse fluxo, após gerar o link, você deve copiá-lo e colar no navegador, para prosseguir com a instalação.

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

Já integrei a Shopify. Por que meu checkout não está funcionando?

Agora que a integração foi realizada com sucesso, reveja alguns pontos importantes para o funcionamento adequado do seu checkout. Se a sua integração não estiver funcionando conforme esperado, verifique os seguintes pontos:

1. Cadastre o seu domínio próprio na Yampi.

Embora a inclusão do domínio não seja obrigatória, se você utiliza seu domínio próprio na Shopify, é necessário que cadastre também em nosso painel.

Para configurar o seu domínio, acesse:

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

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

🔍 Para saber como realizar os apontamentos do checkout em seu gerenciador de domínios, clique aqui.

Ressaltamos a necessidade dessa ação, pois a falta de domínio pode gerar conflitos na integração e problemas no redirecionamento do Checkout.

2. Cadastre uma afiliação de pagamento.

Sem uma afiliação de pagamento cadastrada em sua loja, possivelmente o checkout não irá funcionar.

Para cadastrar uma afiliação, siga essas etapas:

Passo 1 - Acesse Checkout" → Pagamento.

Passo 2 - Clique em “Afiliações de pagamento “→ “+ Nova Afiliação”.

Uma vez que o seu domínio esteja cadastrado com sucesso, é preciso esperar até 30 minutos para que ele propague. Quando a propagação estiver pronta, o domínio da sua loja também estará disponível no seu checkout Yampi.

Se após aguardar ainda houver problemas, contate nosso suporte pelo chat (das 9h às 17h) ou envie uma mensagem do ocorrido para [email protected].

3. Resquícios do código de outro checkout em seu tema

Caso tenha vindo de outro checkout, ou tenha realizado um teste com outro checkout, podem ter ficado alguns resquícios em seu tema. Quando há resquícios do código do Snippet de outro checkout no tema do Shopify, é preciso remover esse código para que o checkout da Yampi funcione corretamente.

Esses códigos podem causar conflito com o checkout da Yampi e afetar o funcionamento do seu checkout.

Como identificar?

Abaixo, vamos listar formas de você identificar se é este problema que está ocorrendo em seu checkout:

1. Ao clicar no botão "Adicionar ao carrinho" ou "Finalizar compra", a tela fica carregando e não redireciona para o checkout da Yampi;

2. Ao clicar no botão "Adicionar ao carrinho" ou "Finalizar compra", é redirecionado para uma página com o Erro 404;

3. Ao clicar no botão "Adicionar ao carrinho" ou "Finalizar compra", é direcionado para uma página que tenha na url /a/pagamento ou /a/checkout;

4. Ao clicar no botão "Adicionar ao carrinho" ou "Finalizar compra", é direcionado ao checkout nativo da sua loja.

Como resolver?

É necessário remover este código para o nosso checkout ativar.

Temos um vídeo onde ensinamos como remover, é só clicar aqui.

⚠️Atenção: Caso não funcione, entre em contato com o nosso suporte para verificarmos de forma exclusiva com você. É só nos chamar clicando no ícone de atendimento em seu painel, ou caso estivermos fora do horário de atendimento, nos encaminhe um e-mail para [email protected].

4. Botão dinâmico ativo (Compre já) e Carrinhos Ajax

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 compativeis com checkouts de terceiros como o da Yampi, porque o botão de finalização utiliza o redirecionamento padrão para o checkout nativo da Shopify.

Por este motivo, é recomendado:

Botão "Compre Já": precisa ser desativado diretamente na personalização do tema na Shopify.
Carrinho AJAX: você pode removê-lo seguinto o passo a passo que disponibilizamos abaixo neste artigo; ou mantê-lo solicitando ao nosso time de suporte o ajuste do botão diretamente no código do tema.

Como desativar o botão Compre já?

O nosso Checkout funciona apenas com o "Adicionar ao carrinho". Sendo assim, é necessário que você remova o botão "Compre já".

Nesse vídeo, Ralph Almeida ensina como desativar o botão Compre já.

Para remover, siga esses passos:

Passo 1 - Dentro do admin do Shopify, navegue em "Temas" → "Customizar".

Passo 2 - Navegue até no template de "Página de Produto".

Passo 3 - Vá até a seção "Página de produto".

Passo 4 - Desmarque o checkbox do "Botão dinâmico de compra".

Como desativar o carrinho Ajax?

Aqui, você encontrará instruções para remover esse recurso nos principais temas da Shopify caso queira fazer o ajuste por conta própria. Se preferir manter o carrinho lateral, basta entrar em contato com o nosso time de suporte.

O carrinho ajax é uma janela/popup lateral que se abre quando o produto é adicionado ao carrinho. Ele é um recurso próprio do Shopify e você precisa apenas desativar esse recurso, para que seu cliente passe realmente pela página de carrinho, ao invés de abrir esse pop-up.

Em cada tema essa configuração fica em um local específico. Recomendamos que contate os desenvolvedores do seu tema para que os mesmos indiquem o caminho exato dessa ação.

Mostramos como desativá-lo nos seguintes temas:

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

Booster

Passo 1 - Dentro do admin do Shopify, navegue em Loja Virtual → Temas → Customizar

Passo 2 - Navegue no template até Página de Produto → selecione Direct to Cart > desative "Show Dynamic checkout button"

Brooklyn

O Checkout da Yampi não funciona se você utilizar o carrinho ajax do Shopify. Para desabilitar esse recurso no tema Brooklyn, faça o seguinte:

Passo 1 - Dentro do admin do Shopify, navegue em Loja Virtual → Temas → Customizar

Passo 2 - No canto inferior, clique em Theme Settings

Passo 3 - No menu lateral a direta, clique em CART PAGE e altere o Cart Type para a opção Page

Debut

Passo 1 - Dentro do admin do Shopify, navegue em Loja Virtual → Temas → Customizar

Passo 2 - Navegue no template até Página de Produto:

Passo 3 - No menu lateral esquerdo, selecione Product Pages:

Passo 4 - No menu lateral direito, desmarque a opção Show dynamic checkout button e salve:

Venture

Passo 1 - Dentro do admin do Shopify, navegue em Loja Virtual → Temas → Customizar

Passo 2 - Navegue no template até Página de Produto:

Passo 3 - No menu lateral esquerdo, selecione Product Pages e então desmarque a opção Show dynamic checkout button e salve.

Warehouse

Passo 1 - Dentro do admin do Shopify, navegue em Loja Virtual → Temas → Customizar

Passo 2 - No canto inferior, clique em Theme Settings

Passo 3 - No menu lateral a direta, clique em CART e altere o Cart Type para a opção Page

Horizon

Passo 1 - Em "Loja Virtual", ou "Online Store", clique em "Editar tema".

Passo 2 - No menu lateral esquerdo, clique no ícone de engrenagem.

Passo 3 - Localize a opção de "Carrinho" (ou "Cart") e clique para expandir as opções.

Passo 4 - Em "Tipo", ou "Type", mude para "Página", ou "Page".

Passo 5 - Salve a alteração.

⚠️ Atenção⚠️

Caso realize todas essas etapas, e seu checkout, embora instalado, não funcionar, pode ser que seu tema seja incompatível com o Checkout. Para averiguarmos, pedimos que abra um chamado com o nosso suporte através do chat ou e-mail.

6. Tema incompatível

Caso tenha verificado todos esses pontos e mesmo assim seu checkout não esteja funcionando, pode tratar-se de alguma incompatibilidade no tema, tendo em vista que existem milhares de possibilidades no tema da plataforma em questão. Recomendamos que contate o nosso suporte pra verificar essa questão e te auxiliar.

Não conseguiu resolver? 🤔

Ei, não precisa se preocupar! Sabemos que algumas coisas não conseguimos verificar por aqui e está tudo bem, temos uma equipe de especialistas pra te ajudar!

É só clicar no ícone de atendimento em seu painel ou pelo e-mail [email protected]. O atendimento fica disponível de Segunda a Sexta, das 9h Às 17h 💜

Dúvidas frequentes 🤔

Erro ao instalar: ''Credenciais inválidas. Token de acesso, Chave de API ou Chave secreta da API estão errados'' . O que fazer?

Verifique os seguintes pontos:

Verifique se as credenciais que você inseriu na Yampi, são as mesmas geradas no Shopify. Compare e vejam se estão nos seus respectivos campos.
Verifique se se a URL está correta, conforme mostramos aqui.
Verifique se se as permissões foram marcadas corretamente, como mostramos aqui.

Algumas fotos aparecem quebradas no checkout. O que fazer?

É provável que a foto tenha chegado quebrada em nosso painel. Neste caso, recomendamos que exclua esse produto aqui na Yampi e importe novamente.

Para isso selecione o produto em questão aqui na Yampi, indo em “Produtos" → "Ver todos” e exclua o mesmo. Após excluir, aguarde 5 minutos e importe de novo clicando no botão “Importar do Shopify”.