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

🎉  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.

2.2 — Criar o app

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

1. Selecione a opção "Start from Dev Dashboard" (Começar pelo Dev Dashboard).
2. Dê um nome ao app. Sugestão: CartPanda Checkout.

📌 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 ("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.

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.

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.

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

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

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.

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".

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.

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¨

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 — consulte o artigo de suporte sobre cupons para mais detalhes.

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á¨

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

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

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.__

Atualizado em: 01/04/2026