Integração entre Shopify e Cartpanda

Veja as dúvidas frequentes sobre a integração entre a Shopify e a Cartpanda.

A Cartpanda funciona como checkout dentro de uma loja Shopify?

• Sim. Você mantém a loja e o catálogo de produtos na Shopify e usa o checkout transparente de 1 página da Cartpanda.

Confira o passo a passo da integração em Como ativar o Checkout da Cartpanda na Shopify.

O que é sincronizado entre as duas plataformas?

• Produtos: da Shopify para a Cartpanda, automaticamente quando realizada a integração.
• Pedidos: da Cartpanda para a Shopify.
• Cupons de desconto: Importados da shopify para a Cartpanda ( se houver descontos criados na shopify) ou pode criar diretamente na Cartpanda. Confira o passo a passo
• Estoque: sincronizados de acordo com o estoque do produto na shopify.

O que é o “domínio raiz” da Shopify?

• É o endereço que termina em .myshopify.com (em Shopify > Configurações > Domínios) na integração, você deve usar este domínio.

Fiz a integração, mas não funcionou. O que fazer?

• O cliente está caindo no checkout da Shopify, mesmo com a integração concluída seguindo o passo a passo do artigo Como ativar o Checkout da CartPanda na sua loja Shopify?

Na maioria dos casos, o problema é uma configuração do tema, um resquício de outro checkout ou uma conexão que não foi concluída. Confira na ordem abaixo.

1. Você tem um plano ativo?

• Para a integração com a Shopify funcionar, é preciso ter um plano ativo a partir do Light.
• Confira em seu painel Cartpanda, em Admin > Planos e cobranças.

2. A importação dos produtos deu certo?

No painel da Cartpanda, em Apps > Cartpanda + Shopify > Credenciais da Shopify, clique em Importar produtos:

• Aviso verde: a conexão está correta.
• Aviso vermelho: as credenciais estão diferentes entre o app da Shopify e o da Cartpanda (confira Client ID e Secret, sem espaços), ou aparece uma destas mensagens:
• • “Uma importação está em progresso”: aguarde terminar.
  • “Permita os seguintes escopos”: falta permissão no app criado na Shopify.
  • “Essa conta Shopify está bloqueada”: fale com o suporte.

3. A sua loja Shopify já está ligada a outra conta Cartpanda?

• Uma loja Shopify só pode estar conectada a uma conta Cartpanda. Se ela já foi conectada em outra conta e o vínculo continua, novas integrações ficam bloqueadas.
• Como resolver:
• • Se você tem acesso à outra conta (ou outras lojas Cartpanda suas), acesse essa loja, vá em Apps > Cartpanda + Shopify, remova as credenciais e salve.
  • Se não tem acesso, acione o nosso suporte para que possamos verificar e desconectar a loja que não utiliza mais.

4. Botão “Compre já” e carrinho lateral

• Compre já ativo: Desative em seu painel da shopify: Loja virtual > Temas > Personalizar > Produto padrão > Informações do produto > Botões comprar, desmarcando a opção Botões de checkout dinâmico.
• Carrinho lateral (AJAX) ou POP UP ativo: em Configurações do tema > Carrinho > Tipo do carrinho, escolha página, os carrinhos modo AJAX, ou POP UP não é compatível com a integração.
• Depois, reimporte os produtos e aguarde cerca de 5 minutos.

5. Havia outro checkout instalado?

• Esse é um dos problemas mais comuns: resquícios de outro checkout no tema da loja conflitam com o checkout da Cartpanda.
• Desinstale o app do checkout anterior na área de apps na sua conta shopify e remova os códigos do checkout anterior do tema ( no arquivo theme.liquid)

6. Filtro de produtos

• Produtos adicionados na aba Filtro de produtos do app Cartpanda + Shopify vão para o checkout nativo da Shopify. Remova-os.

7. Trocou de tema?

• Reimporte os produtos em Apps > Cartpanda + Shopify > Credenciais da shopify > Importar produtos, assim o código do checkout Cartpanda é instalado no novo tema.

8. Gateway e domínio

• Gateway: configure um gateway e um método de pagamento em Admin > Pagamentos.
• Domínio: não use na Cartpanda o mesmo domínio personalizado da Shopify. Deixe o nativo ou crie um Subdominio.

Ainda não resolveu?

Fale com o suporte (suporte@cartpanda.com ou chat) e envie:

• a URL da sua loja Shopify e o domínio .myshopify.com;
• o e-mail de login da Cartpanda;
• um print do aviso ao importar produtos;

Em alguns casos pode ser necessário refazer a integração. O suporte orienta, se for o caso.

Eu usava outro checkout na Shopify e estou migrando para o da Cartpanda. Preciso fazer algo?

Sim. Antes de usar o checkout da Cartpanda, é preciso remover o checkout anterior da sua loja, senão os códigos entram em conflito e a Shopify não redireciona o cliente para o checkout da Cartpanda.

O que fazer:

1. Desinstale o app do checkout antigo na Shopify.
2. Remova os vestígios de código de outros checkouts no tema atual:
3. • Vá ao editor de código do tema (Temas > Editar código).
   • Pesquise por theme.liquid e apague os trechos do checkout anterior.
   • Veja o passo a passo em vídeo: como remover vestígios de outros checkouts.
3. Confira outras pastas de código. Em alguns casos há resquícios em outros arquivos, como cartxCheckoutSnippet.liquid, ou códigos inseridos diretamente em botões.
4. Reimporte os produtos em Apps > Cartpanda + Shopify > Importar produtos, para a integração instalar o código da Cartpanda, aguarde até 15 minutos.
5. Faça um teste através de uma aba anônima do navegador: em sua loja, adicione um produto ao carrinho, clique em Finalizar compra e confira se abre o checkout da Cartpanda.

Em dúvida sobre o que apagar?

• Em caso de código inserido em botões ou arquivos que você não reconhece, recomendamos contatar a plataforma do checkout anterior, que sabe o que instalou, e como remover.
• Ou fale com o suporte da Cartpanda e envie a URL da loja e um print do trecho de código em dúvida.

Preciso pagar a Shopify e a Cartpanda?

• Você continua pagando o plano da Shopify. Na Cartpanda, vale o plano (a partir do Light) mais a taxa do gateway, confira nossos planos: Cartpanda - Planos e Preços

O que faz a opção “Pular carrinho da shopify?

• Ativada: o cliente vai direto ao checkout da Cartpanda ao clicar no botão de compra.
• Desativada: passa antes pela página de carrinho da Shopify.

Como sei se a integração funcionou?

• Faça um teste: Acesse sua loja shopify, adicione um produto ao carrinho, clique em Finalizar compra e confira se abre o checkout da Cartpanda.

Se não funcionou, confira: Por que meu checkout Cartpanda não funciona na Shopify?

Posso ligar a mesma loja Shopify a duas contas Cartpanda?

• Não, isso gera conflito. Fale com o suporte para desconectar da conta anterior.

Alterei o carrinho do tema para modo página, mas o botão de compra não aparece. O que fazer?

Em alguns temas, ao mudar o carrinho para modo página, o botão de compra deixa de ser exibido. Dá para corrigir com um ajuste simples no código do tema.

Passo a passo:

1. Na Shopify, vá até o seu tema atual > Editar código.
2. Na pasta Snippets, abra o arquivo cartCheckoutSnippet.liquid.
3. Procure por has_multiple. Normalmente ele está por volta da linha 67.
4. Troque o valor de 0 para 1.
5. Salve e atualize a página do produto (de preferência em aba anônima) para conferir se o botão voltou.

Não encontrou o arquivo ou o has_multiple? Fale com o nosso suporte (suporte@cartpanda.com ou chat)

Como importo meus produtos para a Cartpanda?

• Em Apps > Cartpanda + Shopify > Credenciais da Shopify, informe o domínio da Shopify (só a parte inicial), o Client ID e o Secret, e clique em Importar produtos. Confira em Produtos > Listar produtos. Veja Importando produtos da Shopify.

A importação deu aviso vermelho. O que significa?

• “Uma importação está em progresso”: aguarde terminar.
• “Permita os seguintes escopos”: falta permissão no app criado na Shopify.
• “Essa conta Shopify está bloqueada”: fale com o suporte.
• Sem mensagem específica: as credenciais costumam estar diferentes entre os dois apps.

Onde configuro frete, gateway e personalizo meu checkout?

• Na Cartpanda. Na Shopify ficam só as configurações da loja virtual e produtos.

Produtos e Pedidos

Posso editar produtos na Cartpanda, isso irá refletir na Shopify?

• Não. A Cartpanda não envia produtos de volta. Os produtos devem ser gerenciado na Shopify.

Pedidos criados manualmente na Shopify aparecem na Cartpanda?

• Não. Só os pedidos finalizados no checkout da Cartpanda vão para a Shopify

Meus produtos novos não aparecem na Cartpanda.

• A sincronização é automática. Se não aparecerem, realize a importação manualmente em Credenciais da Shopify > Importar produtos.

Onde atualizo o código de rastreio do pedido: na Shopify ou na Cartpanda?

• Na Shopify. Quando você adiciona o código de rastreio ao pedido lá, a Cartpanda o recebe e atualiza o status do pedido.

Onde faço o reembolso de um pedido?

Depende do gateway que você usa.

• Cartpanda Pay: faça o reembolso direto no painel da Cartpanda, e não pela Shopify. Caminho: na página do pedido > Reembolsar. Veja os prazos e regras em Reembolso no Cartpanda Pay.
• Gateway externo (que não seja o Cartpanda Pay): consulte o suporte do gateway para saber onde o reembolso é feito. Não é possível reembolsar pela Cartpanda.

Os cupons criados na Shopify funcionam no checkout da Cartpanda?

Sim. Os cupons criados na Shopify são sincronizados para a Cartpanda e podem ser usados no checkout, com o mesmo código, o mesmo tipo e o mesmo valor de desconto.
Como funciona:

• A sincronização é automática, em poucos minutos depois de você criar o cupom na Shopify.
• Os cupons existentes não são duplicados quando a sincronização roda de novo.
• Você também pode criar o cupom direto na Cartpanda. Veja Cupom de desconto.

Seu cupom da Shopify ainda não apareceu na Cartpanda? Force a sincronização:

1. No painel da Cartpanda, vá em Apps > Cartpanda + Shopify > Forçar sincronização.
2. Aguarde alguns minutos.
3. Confira se o cupom aparece e teste no checkout.

Meu cupom da Shopify não aparece ou não funciona no checkout da Cartpanda. O que fazer?

Confira na ordem:

1. Sincronização: o cupom foi criado há poucos minutos? Aguarde e, se não aparecer, force a sincronização. ( Apps > Cartpanda + Shopify > Forçar sincronização.)
2. Código e valor: confira se o código e o desconto inserido no Checkout Cartpanda é igual ao código do desconto na shopify.
3. Regras do cupom: valor mínimo, produto elegível, validade e limite de uso podem impedir a aplicação no checkout, dependendo se o produto que está no carrinho atende a regra.
4. Alternativa: se o cupom não sincronizar, crie-o direto na Cartpanda.

Ainda não resolveu? Fale com o suporte e envie:

• a URL da loja e o e-mail de login;
• o código do cupom e um print dele na Shopify;
• um print do erro no checkout, se houver.

Criei um pedido pela Shopify e ele não aparece na Cartpanda, por quê?

• Só os pedidos finalizados no checkout da Cartpanda são enviados à Shopify. Pedidos criados direto na Shopify não são importados.

Meu cliente recebeu dois e-mails de confirmação de pedido. Por quê?

• Com a integração, a Shopify e a Cartpanda podem enviar e-mails do mesmo pedido, e por isso o cliente recebe os dois. Você escolhe qual dos dois quer manter.

Opção 1: manter só os e-mails da Cartpanda (desativar os da Shopify)

1. No painel da Cartpanda, vá em Apps > Cartpanda + Shopify.
2. Localize a opção “Enviar e-mails transacionais através da Shopify”.
3. Deixe-a desativada e salve.

Opção 2: manter só os e-mails da Shopify (desativar os da Cartpanda)

1. Vá em Admin > Notificações.
2. Clique no e-mail que está duplicado (por exemplo, a confirmação de pedido).
3. Desmarque a opção de enviar o e-mail e salve.

Cuidado: não desative os dois. Se isso acontecer, o cliente fica sem confirmação de compra e pode achar que o pedido não foi feito.
Para conferir: faça um pedido de teste com um e-mail que possui acesso e veja quantos e-mails chegam.
Veja mais em Gerencie as notificações da sua loja.

Alterei o preço de um produto na Shopify e não mudou no Checkout. O que fazer?

O preço é sincronizado automaticamente. Se não refletir no checkout, importe os produtos de novo.
Como fazer:

1. No painel da Cartpanda, vá em Apps > Cartpanda + Shopify > Credenciais da Shopify.
2. Clique em Importar produtos.
3. Aguarde cerca de 5 minutos. O checkout passa a mostrar o novo preço.

Dica: Teste em uma aba anônima, para descartar o cache.

Excluí um produto na Shopify. Ele some na Cartpanda?

Sim, pois esse produto deixa de existir em sua loja shopify.
Se ele continuar aparecendo:

1. Confira aqui na Cartpanda em Produtos > Listar produtos.
2. Se ainda estiver lá, faça a reimportação em Apps > Cartpanda + Shopify > Credenciais da Shopify > Importar produtos e aguarde alguns minutos.

Atenção: se o produto excluído estava em um order bump, upsell ou template de checkout, vale conferir e ajustar essas ofertas.

O estoque é atualizado?

Sim. O estoque segue o que está na Shopify.

• Atualize o estoque na Shopify, que é onde o catálogo de produtos é gerenciado.
• Se um produto esgotar de estoque na shopify, o cliente não consegue fazer a compra no checkout. ( se na configuração do produto da shopify, não estiver marcada a opção: Continuar vendendo mesmo sem estoque)

O que eu mudo na Shopify e o que eu mudo na Cartpanda?

Se alguma mudança da Shopify não aparecer na Cartpanda: reimporte os produtos e aguarde cerca de 5 minutos.

Quem recupera o carrinho abandonado: a Shopify ou a Cartpanda?

A Cartpanda. Como o checkout é da Cartpanda, a recuperação nativa de carrinhos abandonados também é feita pela Cartpanda.
Como funciona:

• Quando o cliente preenche e-mail e telefone no checkout e desiste da compra, esses dados são capturados.
• A Cartpanda usa essas informações para enviar e-mails e SMS de recuperação, de forma automática.

Onde conferir:

• No painel da Cartpanda, vá em Pedidos > Checkouts abandonados.
• Veja mais em Recuperação de carrinhos abandonados.

O número do pedido é diferente na Shopify e na Cartpanda. Por quê?

É normal. Cada plataforma tem a sua própria numeração, e por isso o mesmo pedido aparece com números diferentes.

• Na Cartpanda, os pedidos têm numeração crescente, começando em 1.
• Não dá para alterar o número completo, mas você pode acrescentar um prefixo ou sufixo em Admin > Geral > Padrões e formatos. Isso aparece no painel de pedidos e nas notificações enviadas aos clientes. Veja Alterar número do pedido.

Meu pedido finalizado na Cartpanda não chegou à Shopify. O que fazer?

Force a sincronização.

1. No painel da Cartpanda, vá em Apps > Cartpanda + Shopify > Forçar sincronização.
2. Aguarde até 10 minutos.
3. Volte à Shopify, recarregue a página de pedidos e confira.

Lembre-se:

• Só os pedidos finalizados no checkout da Cartpanda vão para a Shopify. Pedidos criados direto na Shopify não são importados.
• Se continuar sem chegar, confira se a integração está ativa, se estiver tudo certo e ainda assim não constar o pedido na shopify, acione nosso suporte.

O status do pedido na Shopify não acompanha o da Cartpanda. Por quê?

A Cartpanda envia à Shopify as informações do checkout: pedido criado, pedido confirmado e pagamento aprovado ou pendente.

• O que acontece depois (não processado, processado, reembolsado, cancelado) segue regras próprias. Por exemplo, o rastreio é recebido da Shopify pela Cartpanda. ( atualiza para: processado)
• Se o status não bater, force a sincronização entre as plataformas.

Onde faço a gestão dos meus pedidos?

• Se o seu gateway é o Cartpanda Pay, gerenciar pela Cartpanda é mais fácil: você acompanha os pedidos, as taxas e o reembolso (se necessário) no mesmo lugar.
• Veja Gerencie seus pedidos.

Como altero o endereço de um pedido já feito?

Altere na Cartpanda, quando o cliente avisar que escreveu o endereço de forma incorreta.

1. Vá em Pedidos > Todos os pedidos e abra o pedido.
2. Em Endereço de entrega, clique no ícone de lápis.
3. Altere o endereço e salve.

Obs: Essa alteração ocorre somente na Cartpanda, não altera o pedido na Shopify.

Um pedido aparece na Shopify como “Reembolso devido”. O que significa?

Não há nenhum reembolso a fazer. O valor que a Shopify mostra como “reembolso devido” corresponde apenas aos juros do parcelamento do pedido, ou taxas.
O que aconteceu:

• O cliente pagou o pedido parcelado, com juros, então o valor total pago ficou maior que o valor dos produtos.
• A Shopify exibe como se fosse um reembolso devido.
• É só uma questão de visualização na Shopify, e o pedido está correto.

Exemplo: um pedido de R$ 100,00 parcelado, com total de R$ 110,00. A Shopify pode mostrar R$ 10,00 como “reembolso devido”, que são os juros pagos pelo cliente.
O que fazer:

• Nada. Não é preciso reembolsar esse valor.
• Guie-se sempre pela página do pedido na Cartpanda, onde os valores pagos, inclusive os juros, aparecem corretamente.

Posso alterar o status de um pedido na Shopify?

• Não é recomendado. O ideal é sempre deixar o pedido no fluxo automático.

Como funciona:

• Quando o cliente paga no checkout, a Cartpanda envia essa informação para a Shopify.
• O pedido é atualizado automaticamente para “pago”, sem você fazer nada.
• Se o pagamento ainda não foi confirmado (boleto ou Pix não pago), o pedido continua pendente até a confirmação.

Por que evitar a alteração manual:

• Mudar o status só na Shopify não muda o que acontece na Cartpanda, e os dois sistemas passam a mostrar situações diferentes.
• Fica mais difícil conferir o que foi pago e o que não foi.

O status parece errado? Faça isto:

1. Confira a situação do pedido na Cartpanda (Pedidos > Todos os pedidos).
2. Se estiver pago lá e não na Shopify, force a sincronização: Apps > Cartpanda + Shopify > Forçar sincronização, aguarde até 10 minutos e recarregue a página de pedidos.
3. Se continuar diferente, fale com o suporte e envie o número do pedido, a URL da loja e um print das duas telas.

Não encontrou o que procurava? Fale com o nosso time pelo chat da plataforma ou por suporte@cartpanda.com. Informe o e-mail de login da sua conta e, se puder, explique e envie um print do que está acontecendo.

Atualizado em: 27/10/2026