> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cartpanda.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://help.cartpanda.com/pt-br/article/como-ativar-o-checkout-da-cartpanda-na-sua-loja-shopify-5fch8r/).

###### 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](https://help.cartpanda.com/pt-br/article/cupom-de-desconto-soqatl/)
* **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](https://help.cartpanda.com/pt-br/article/como-ativar-o-checkout-da-cartpanda-na-sua-loja-shopify-5fch8r/)?
  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](https://help.cartpanda.com/pt-br/article/adicione-seu-dominio-proprio-a-cartpanda-1dwid5f/).

###### Ainda não resolveu?

Fale com o suporte ([**suporte@cartpanda.com**](mailto: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:
   * 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](https://www.youtube.com/watch?v=BxE7SPYyjOQ).
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](https://cartpanda.com.br/precos)

###### 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?](https://help.cartpanda.com/pt-br/article/por-que-meu-checkout-cartpanda-nao-funciona-na-shopify-3kn6ny/)

###### 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**](mailto: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](https://help.cartpanda.com/pt-br/article/importando-produtos-da-shopify-12wv6y1/).

**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](https://help.cartpanda.com/pt-br/article/entenda-o-processo-de-reembolso-de-pagamentos-com-cartpanda-pay-1wm4c2x/).
* **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](https://help.cartpanda.com/pt-br/article/cupom-de-desconto-soqatl/).

**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](https://help.cartpanda.com/pt-br/article/gerencie-as-notificacoes-da-sua-loja-1pqinml/).

###### 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?

| Item | Onde gerenciar | Observação |
| ---- | ---- | ---- |
| Produtos (criar, editar, excluir) | **Shopify** | Sincroniza para a Cartpanda |
| Preço e título | **Shopify** | Sincronizados automaticamente |
| Estoque | **Shopify** | A Cartpanda segue a Shopify |
| Rastreio | **Shopify** | A Cartpanda recebe e atualiza o status |
| Gateway, frete e descontos do checkout | **Cartpanda** | Não vêm da Shopify |
| Reembolso (Cartpanda Pay) | **Cartpanda** | Não pela Shopify |
| Pedidos do checkout | **Cartpanda** | Enviados para a Shopif |

**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](https://help.cartpanda.com/pt-br/article/recuperacao-de-carrinhos-abandonados-11pjep9/).

###### 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](https://help.cartpanda.com/pt-br/article/alterar-numero-do-pedido-1qn4nsu/).

###### 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](https://help.cartpanda.com/pt-br/article/gerencie-seus-pedidos-e5sbif/).

###### 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**](mailto:suporte@cartpanda.com). Informe o e-mail de login da sua conta e, se puder, explique e envie um print do que está acontecendo.