> ## 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).

# Como ativar o Checkout da CartPanda na sua loja Shopify

Este guia explica, passo a passo, como utilizar o **Checkout Transparente de 1 página da Cartpanda** dentro da sua loja Shopify, mantendo produtos e pedidos sincronizados entre as plataformas.

Essa solução é ideal para lojistas que desejam melhorar a conversão com o checkout da Cartpanda, sem precisar migrar completamente sua loja neste momento.

# Por que usar o checkout da Cartpanda na Shopify?

Ao integrar o checkout da Cartpanda com sua loja Shopify, você poderá:

✅ Utilizar um checkout otimizado e focado em conversão
✅ Manter sua loja e catálogo ativos na Shopify
✅ Sincronizar automaticamente produtos, pedidos, clientes e estoque
✅ Utilizar cupons e regras existentes
✅ Preparar sua operação para uma futura migração completa, sem retrabalho

# Visão geral da integração Cartpanda + Shopify

A integração funciona por meio de um **aplicativo criado no ecossistema da Shopify**, que permite a comunicação segura entre as plataformas. De forma resumida:

* Produtos são sincronizados da Shopify para a Cartpanda
* Pedidos finalizados no checkout da Cartpanda são enviados para a Shopify
* Estoque é atualizado com base nas regras definidas
* Clientes e cupons são sincronizados automaticamente
* O checkout da Cartpanda é aberto via redirecionamento seguro

**A sincronização ocorre automaticamente e em tempo real após a instalação.**

# Antes de começar

Antes de iniciar a integração, certifique-se de que você já tem:

* **Uma conta ativa na Cartpanda**. Caso queira testar o checkout também precisará estar com um plano ativo, a partir do light.
* **Uma loja Shopify funcionando normalmente** — com acesso administrativo.
* Uma conta no **Shopify Partners**, é por lá que o aplicativo da integração será criado.

# Visão geral do processo

A integração é feita em 4 passos principais:

1. **Criar conta no Shopify Partners** — a Shopify exige isso para que apps externos possam ser instalados na sua loja.
2. **Criar e configurar o app da Cartpanda** — você vai criar um aplicativo dentro do painel da Shopify e apontá-lo para a Cartpanda.
3. **Inserir as credenciais na Cartpanda** — isso conecta o app que você criou com a sua conta Cartpanda.
4. **Configurações finais e validação** — ajustes de comportamento e um teste para confirmar que está tudo funcionando.

**📌 Cada passo está explicado em detalhes abaixo. Leia com atenção antes de executar.**

# Passo 1 – **Criar conta no Shopify Partners**

Para integrar o Checkout da Cartpanda à sua loja Shopify, é necessário criar um app na sua conta Shopify. Para isso, é obrigatório utilizar uma conta do Shopify Partners — uma conta exclusiva para parceiros que desejam criar apps dentro do ecossistema Shopify. Se você nunca acessou o painel Shopify Partners, não se preocupe: o processo é rápido e simples.

Link para o Shopify Partners > https://www.shopify.com/br/parcerias

**📌 Se você já tem conta no Shopify Partners: Basta fazer login e pular direto para o Passo 2.**

###### Se ainda não tem conta, siga os passos abaixo:

1. **Clique em "Criar conta"** no canto superior direito da página.
2. Selecione a forma que deseja realizar o cadastro da conta. ( Recomendamos utilizar o mesmo e-mail da sua loja Shopify)
3. Preencha o formulário com as informações da sua empresa. Abaixo estão as perguntas que aparecerão e o que selecionar em cada uma:

###### Como você quer começar como Parceiro?
→ Selecione: **"Criar e configurar uma nova organização Parceira"**
  (em inglês: *"Create and set up a new Partner organization"*)

###### Qual é o seu principal foco como Parceiro da Shopify?
→ Selecione: **"Criação de apps"**
  (em inglês: *"App development"*)

###### Onde fica sua empresa?
→ Selecione seu país (**Brasil**) e, em seguida, o estado.

###### Informações de contato da empresa:
→ Preencha com os dados básicos da sua loja ou empresa.

Clique em **"Criar organização Parceira"** (ou *"Create Partner organization"* em inglês).

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/captura-de-tela-3424_deyx4r.png =1072xauto)
![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/captura-de-tela-3425_1s1j0pj.png =1067xauto)
![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/captura-de-tela-3427_uv9zwi.png =1061xauto)

🎉  Pronto, sua conta no Shopify Partners está criada!

📌\* Guarde o e-mail e a senha dessa conta — você pode precisar deles novamente nos próximos passos.\*

# Passo 2 – **Criar e configurar o app da Cartpanda na Shopify Partners**

Agora que você tem a conta no Shopify Partners, o próximo passo é criar um aplicativo. Esse app funciona como uma "ponte" entre a sua loja Shopify e a Cartpanda — é ele que permite a comunicação entre as duas plataformas.

⚠️ **É essencial acessar o painel de criação de apps pelo caminho correto, descrito abaixo. Outros acessos não liberam todas as configurações que precisamos.**

### 2.1 — Acessar o Dev Dashboard

Com o painel do Shopify Partners aberto, siga o caminho abaixo no menu lateral esquerdo:

**Distribuição de apps → Todos os apps → Visitar o Dev Dashboard**
Em inglês: *App distribution → All apps → Visit Dev Dashboard*

Isso vai abrir o painel de desenvolvimento da Shopify (Dev Dashboard), que é onde você vai criar e configurar o app.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify2-1_5fa2yz.png =1265xauto)
### 2.2 — Criar o app

1. No menu lateral, clique em **"Apps"**.
2. Clique em **"Create app"** (Criar app).

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify5_6alddd.png =1264xauto)
1. Selecione a opção **"Start from Dev Dashboard"** (Começar pelo Dev Dashboard).
2. Dê um nome ao app. Sugestão: **CartPanda Checkout**.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify4_1dlqof.png =1262xauto)
📌\* O nome do app é apenas para sua identificação interna — o cliente final não vê esse nome.\*

### 2.3 — Configurar a URL do app

No campo "App URL", apague o texto que já vem preenchido ("${color}[#616161](example.com)") e cole a URL abaixo:

https://accounts.cartpanda.com/apps/shopify-onboarding

⚠️\*\*  Não deixe o "example.com" junto com a URL da CartPanda. O campo deve conter apenas a URL acima.\*\*

### 2.4 — Desmarcar a opção de incorporar o app
Logo abaixo do campo de URL, você vai ver uma opção chamada "**Embed app in Shopify admin**" (em português: *"Incorporar app no admin da Shopify"*).

**Desmarque** essa opção. Se ela ficar marcada, o app não vai funcionar corretamente.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify10_xqxw6h.png =1180xauto)
### 2.5 — Inserir as permissões (Scopes)

Role a página até encontrar a seção "Access" (Acesso). Dentro dela, localize o campo "Scopes" (Escopos).

As permissões dizem à Shopify o que o app da Cartpanda pode acessar dentro da sua loja — como produtos, pedidos e estoque. Copie e cole exatamente o texto abaixo nesse campo:

```
read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,write_customers,read_price_rules,write_price_rules,read_discounts,write_discounts,write_draft_orders,read_draft_orders,read_fulfillments,write_fulfillments,write_inventory,read_inventory,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,write_order_edits,read_order_edits,read_orders,write_orders,read_product_listings,write_product_listings,read_products,write_products,read_content,write_content,read_themes,write_themes,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_gift_cards,write_gift_cards
```

⚠️\*\*  Cole exatamente como está acima, sem adicionar espaços ou remover qualquer parte. Uma permissão errada ou faltando vai impedir a instalação.\*\*

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify7_9azwv5.png =1170xauto)

### 2.6 — Finalizar a criação do app

1. Role até o final da página e clique em **"Release"** (Lançar).
2. Uma janela de confirmação vai abrir — não é necessário preencher nada. Clique em **"Lançar"** novamente.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify11_739qwc.png =1167xauto)

**_📌 Nada deve ser configurado nas seções POS ou App Proxy. Se qualquer uma dessas áreas for alterada, o app pode parar de funcionar._**

### 2.7 — Configurar a distribuição do app

Com o app criado, ainda é preciso dizer à Shopify em qual loja ele vai ser instalado. Esse processo se chama "distribuição".

1. Clique no nome do app que você acabou de criar.
2. Localize a opção **"Distribution"** e clique em **"Select distribution method"** (Selecionar forma de distribuição).

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify27_1tbsr93.png =1287xauto)

3. Você será redirecionado de volta para o painel do Shopify Partners.
4. Selecione **"Distribuição personalizada"** (em inglês: *"Custom distribution"*) e confirme.


![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify14-1_f52bqi.png =1231xauto)

Agora você precisa informar o domínio raiz da sua loja Shopify. Esse é o endereço original que a Shopify criou para sua loja quando você fez o cadastro — ele termina sempre com .myshopify.com.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify16-1_119pcom.png)

###### Como encontrar o domínio raiz da sua loja shopify:

* Abra uma nova aba e acesse: https://admin.shopify.com/
* No canto inferior esquerdo, clique em **"Configurações"** e depois em **"Domínios"**.
* Copie o domínio que aparece no topo da lista — ele vai ter o formato: nomedasualoja.myshopify.com

⚠️  Não use um domínio personalizado (como sualoja.com.br) nesse campo. A Shopify só aceita o domínio raiz .myshopify.com aqui.

* Cole esse domínio no campo do Shopify Partners e clique em **"Gerar link"** (*"Generate link"* em inglês).
* Um link de instalação vai aparecer na tela. Clique em **"Copiar"**.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify18-1_1hcrruv.png =1206xauto)

**Abra uma nova aba no navegador**, cole o link e pressione Enter.

# Passo 3 –  **Instalar o app e conectar com a CartPanda**

**Ao acessar o link gerado no passo anterior, você será levado à tela de login da Shopify. A partir daqui, vamos finalizar a conexão entre as duas plataformas.**

1. Faça login na Shopify e selecione a loja que deseja integrar.
2. Uma tela de confirmação vai aparecer mostrando as permissões que o app vai ter. Clique em **"Instalar app"**.
3. Você será redirecionado automaticamente para o painel da **Cartpanda,** na tela de instalação do app Shopify.

### 3.1 — Inserir o Client ID e o Secret

Agora você vai conectar o app que criou na Shopify com a sua conta Cartpanda. Para isso, você precisa copiar duas chaves de autenticação do Dev Dashboard e colá-las no painel da Cartpanda.

**Como obter as chaves:**

1. Volte ao Dev Dashboard da Shopify Partners (abra em uma nova aba para não perder o que está aberto).
2. Acesse o app que você criou.
3. Clique em **"Settings"** (Configurações) no menu lateral.
4. Você vai ver dois campos: **"Client ID"** e **"Client secret"**. Copie cada um deles.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify31-1_1ptv0v0.png =1267xauto)

**Como inserir as chaves na Cartpanda:**

1. No painel da Cartpanda, cole o **Client ID** no campo **"Client ID"**.
2. Cole o **Secret** no campo **"Secret"**.
3. Clique em **"Importar produtos¨**


![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/6/e/626e5bed518e1800/shopify21-1-1_4ddmdv.png =1227xauto)

||| ⚠️  Atenção redobrada aqui: não inverta os campos das credenciais e não deixe espaços antes ou depois das chaves. Se houver qualquer erro, a integração não vai ser concluída.

# Passo 4 – **Configurações finais e validação**

Com o app instalado, você vai ver no painel da Cartpanda algumas opções de configuração. Revise cada uma delas:

###### Integração ativa
Verifique se a integração está marcada como Ativa. Se ela estiver desativada, o checkout não vai funcionar na sua loja.

###### Pular carrinho de compras
Essa opção define o caminho que o cliente percorre até o checkout:

* **Ativada**: o cliente vai direto para o checkout da CartPanda ao clicar em "Finalizar compra", pulando a página de carrinho da Shopify.
* **Desativada:** o cliente passa pela página de carrinho da Shopify antes de ser redirecionado ao checkout.

**Após revisar todas as configurações, clique em Salvar.**

**Para confirmar que a integração está funcionando corretamente, faça um pedido de teste:**

1. Acesse sua loja Shopify pelo link público.
2. Adicione um produto ao carrinho.
3. Clique em "Finalizar compra".
4. Confirme que você foi redirecionado para o checkout da Cartpanda.

🎉  Se o checkout da Cartpanda abriu corretamente, a integração está 100% funcionando!

# Como funciona a integração Cartpanda + Shopify?

Depois que a integração está ativa, as duas plataformas passam a se comunicar automaticamente. Veja abaixo como cada tipo de dado se comporta:

###### Produtos
**Direção: Shopify → Cartpanda (sincronização automática e em tempo real)**

* **Na primeira instalação:** o catálogo completo da sua loja Shopify é importado automaticamente para a Cartpanda.
* **Novos produtos:** qualquer produto criado na Shopify depois da instalação também é enviado automaticamente para a Cartpanda.
* **Atualizações de preço e título**: alterações feitas na Shopify são refletidas automaticamente na CartPanda.

⚠️  A Cartpanda não envia produtos de volta para a Shopify. O gerenciamento do catálogo deve ser feito sempre na Shopify.

###### Pedidos
**Direção: Cartpanda → Shopify**

* **Pedidos finalizados no checkout da Cartpanda são enviados automaticamente para a Shopify.**
* Pedidos criados diretamente no painel da Shopify **não são** importados pela Cartpanda.

###### Código de rastreio
* Recebimento (padrão): quando um código de rastreio é adicionado ao pedido na Shopify, a Cartpanda o recebe e atualiza automaticamente o status do pedido para "Em transporte".
* Envio para a Shopify (opcional): a Cartpanda também pode enviar o código de rastreio de volta para a Shopify, mas essa função precisa ser ativada pelo suporte.

📌\* Se o código de rastreio for alterado depois de já ter sido enviado, a atualização não é refletida automaticamente na CartPanda.\*

###### Cupons de desconto

Os cupons criados na Shopify podem ser reconhecidos automaticamente no checkout da Cartpanda, sem necessidade de recadastrá-los. A importação segue regras específicas de compatibilidade.

**Observações e personalizações de compra**
Todas as observações feitas pelo cliente durante o checkout (como mensagens, personalizações de produto, etc.) são enviadas junto ao pedido para a Shopify, garantindo que nenhuma informação se perca.

# Ajustes indispensáveis após a instalação

A integração está ativa, mas ainda há alguns ajustes no tema da sua loja Shopify que precisam ser feitos para garantir que os clientes sejam sempre redirecionados corretamente para o checkout da Cartpanda.

**Se esses ajustes não forem feitos, alguns botões nativos da Shopify podem levar o cliente para um checkout diferente — e você perde a venda no fluxo errado.**

**1. Remover o botão de checkout dinâmico ("Compre já")**

A Shopify tem um botão chamado "Compre já" (ou "Buy it now") que aparece na página de produto e leva o cliente diretamente para o checkout padrão da Shopify — pulando o da Cartpanda. Esse botão precisa ser desativado, isso é feito diretamente na edição do tema em sua loja shopify.

📖 **Veja como fazer:** [Removendo o botão de ¨Comprar já¨](https://help.cartpanda.com/pt-br/article/cartpanda-shopify-removendo-o-botao-de-comprar-ja-1wb49e3/)

**2. Desativar o carrinho lateral (Ajax/Mini-cart)**

Carrinhos do tipo "gaveta" ou flutuantes (que aparecem na lateral da tela ao adicionar um produto) podem interferir no redirecionamento para o checkout da Cartpanda. Recomendamos desativá-los
e deixar o carrinho **modo página.**

📖 **Veja como fazer:** [Desativando carrinho lateral AJAX](https://help.cartpanda.com/pt-br/article/cartpanda-shopify-desativando-carrinho-ajax-r1ffsk/)

**3. Configurar o seu subdomínio na Cartpanda**

Para passar mais confiança ao cliente durante o checkout, configure o domínio personalizado da sua loja no painel da Cartpanda.

📖 **Veja como fazer:** [Como configurar o subdominio](https://help.cartpanda.com/pt-br/article/adicione-seu-dominio-proprio-a-cartpanda-1dwid5f/)

---

### Perguntas frequentes:

1. **Fiz tudo, mas não está funcionando. O que pode ser?**

Recomendamos que revise o passo a passo do artigo com atenção e confirme se todas as etapas foram seguidas corretamente, principalmente os pontos mais sensíveis, como URL, permissões (scopes) e chaves de integração.

👉 Em alguns casos, pode ser necessário refazer o processo desde o início para garantir que tudo esteja correto.
Se ainda assim não funcionar, nosso suporte está à disposição para te ajudar.

2. **Minha loja não está redirecionando para o checkout da Cartpanda**

Se o redirecionamento não está acontecendo, normalmente é por algum desses motivos:

👉 **Botão “Compre já” ainda ativo**
Esse botão usa o checkout da Shopify, então precisa estar **desativado**.

👉 **Carrinho lateral ativo**
Recomendamos deixar o carrinho no **modo página**, para garantir o redirecionamento correto.

👉 **Plano da Cartpanda**
Verifique em **Admin → Planos e cobranças** se há um plano ativo (a partir do plano Light). Sem isso, a integração não funciona corretamente.

👉 **Produtos não sincronizados**
Se necessário, tente importar os produtos novamente na Cartpanda.

3. **Posso desfazer a integração depois?**

Sim! Você pode desinstalar o app e refazer a integração a qualquer momento, se precisar.
Nada é definitivo — você tem total controle sobre isso.

###### Resumo final

A integração entre a Cartpanda e a Shopify pode parecer mais técnica à primeira vista, mas seguindo o passo a passo com atenção, você conseguirá concluir todo o processo sem dificuldades.
O mais importante é garantir que cada etapa seja realizada corretamente, principalmente nas configurações do app e na conexão das chaves (Client ID e Secret).

Após a conclusão, sua loja já estará pronta para utilizar o checkout otimizado da Cartpanda, proporcionando uma experiência mais eficiente e focada em conversão para seus clientes.🐼🚀

Caso tenha qualquer dúvida durante o processo, não se preocupe, isso é normal 😊

Chame nosso time no chat da plataforma ou mande um e-mail para [\_\_suporte@cartpanda.com](mailto:suporte@cartpanda.com).\_\_