Como integrar a Shopify à Fliper

A integração conecta sua loja Shopify à Fliper para importar o catálogo e preparar o checkout no tema publicado. Você vai criar um app exclusivo da loja, informar suas credenciais na Fliper e conferir o funcionamento da compra.

Antes de começar

Tenha acesso à loja Shopify e permissão para criar e instalar aplicativos na organização dela.
Tenha sua conta e loja cadastradas na Fliper.
Separe o domínio permanente da loja, terminado em .myshopify.com.
Confira qual tema está publicado. A conexão tenta instalar o checkout nesse tema; faça uma cópia dele na Shopify antes de começar, para preservar suas personalizações.

Atenção: o app e a loja precisam pertencer à mesma organização Shopify. Este guia usa o modelo de app da própria loja. Confira essa condição antes de criar o app. Entenda a exigência da Shopify.

Passo 1 — Abra a configuração na Fliper

Entre no painel Fliper e acesse Configuração.
Em Configurar loja, localize Shopify e clique em Configurar.
Mantenha o modal Configurar Shopify aberto. Você usará os valores de URL do app e Escopos na próxima etapa.
Aguarde a lista de escopos terminar de carregar antes de copiá-la.

Resultado esperado: o painel mostra as orientações de criação do app e os campos para conectar sua loja.

Passo 2 — Crie e instale o app na Shopify

Em outra aba, abra o Dev Dashboard da Shopify na organização que contém a sua loja.
Acesse Apps e crie um app pelo Dev Dashboard. Use um nome que você reconheça, como Fliper Checkout.
Na configuração da versão, preencha App URL / URL do app com o valor mostrado na Fliper.
Desative Embed app in Shopify admin / Incorporar app no admin da Shopify.
Em Scopes / Escopos, cole a lista completa exibida pela Fliper.
Deixe os campos de callback/redirecionamento, App Proxy e POS sem configuração para este fluxo. Não é necessário cadastrar webhook de desinstalação.
Publique a versão pelo comando Release / Lançar e use a ação de instalação do app para selecionar a loja da mesma organização. Confira a loja e aprove as permissões solicitadas.
Nas configurações do app, em Settings / Configurações, localize Client ID e Client secret.

Os rótulos da Shopify podem variar conforme o idioma. O guia oficial de criação no Dev Dashboard explica a organização de apps e versões.

Resultado esperado: o app está instalado na loja correta e você tem acesso às suas duas credenciais.

Passo 3 — Conecte a loja na Fliper

Volte ao modal Configurar Shopify na Fliper.
Em URL da loja, informe o domínio permanente, como sua-loja.myshopify.com, sem https:// ou caminhos adicionais. Você pode conferir esse domínio em Configurações → Domínios na Shopify.
Cole o identificador em Client ID do app e o segredo em Client secret do app.
Clique em Conectar loja e aguarde o resultado.

Segurança: informe o Client secret somente no campo próprio do painel Fliper. Ele não deve ser colocado no tema da loja nem enviado em prints ou mensagens de suporte.

Resultado esperado: a integração aparece como Conectado. A validação acontece no painel Fliper. Ao conectar, a Fliper inicia a importação do catálogo e tenta instalar o checkout no tema publicado. Confira essas duas etapas a seguir, mesmo se a conexão já estiver concluída.

Passo 4 — Confira o catálogo e o tema

Abra Produtos e aguarde a conclusão da sincronização. Confira títulos, variantes e preços de alguns produtos.
Se precisar iniciar uma nova importação, use Sincronizar produtos. Aguarde o processamento antes de repetir a ação.
Volte a Configuração → Shopify → Configurar e confira a seção Checkout da loja.
Se o tema ainda estiver pendente, clique em Instalar no tema e confira o resultado. Uma conexão válida não garante que a Shopify tenha permitido a edição do tema.
Ao publicar outro tema na Shopify, use Reinstalar nesse modal. Na página Instalar checkout na Shopify, a mesma ação aparece como Reinstalar no tema.

Resultado esperado: o catálogo está disponível na Fliper e a interface confirma a instalação no tema publicado.

Passo 5 — Teste a compra

Antes de testar frete e pagamento, conclua as integrações de Frenet e Appmax aplicáveis à sua operação.
Abra a vitrine em uma janela anônima. Escolha um produto, altere variante e quantidade e avance para o checkout.
Repita com dois produtos no carrinho. Confira itens, quantidades e valores apresentados na Fliper.
Para produtos físicos, informe um CEP válido e confira as opções de entrega e o total com frete.
No ambiente de teste disponibilizado para a sua loja, conclua um pagamento de teste e acompanhe sua confirmação. Em produção, concluir um pagamento pode gerar uma cobrança real.
Após a aprovação, confira o pedido correspondente na Shopify e seu acompanhamento na Fliper, verificando itens, frete e total. O envio é processado de forma assíncrona; um pagamento pendente ainda não comprova esse fluxo.

Como confirmar que funcionou

A Shopify aparece como Conectado na configuração.
Os produtos e variantes esperados aparecem em Produtos.
A compra iniciada pelo tema publicado abre o checkout Fliper com os itens corretos.
Um pagamento aprovado no ambiente validado resulta no pedido correspondente, com valores conferidos.

Solução de problemas

O que aconteceu	O que verificar
Domínio inválido	Use o domínio permanente `.myshopify.com`, sem protocolo, e confira a loja selecionada.
App não instalado ou loja não permitida	Confirme a instalação e se app e loja pertencem à mesma organização. Um app de outra organização pode exigir outro modelo de autenticação.
Credenciais inválidas	Confira se Client ID e Client secret são do mesmo app e se foram copiados integralmente.
Escopos ausentes	Compare com a lista atual exibida na Fliper; publique a versão corrigida e aprove as novas permissões na Shopify antes de tentar novamente.
Loja já vinculada	Confira se essa Shopify já está conectada a outra loja Fliper; não crie um segundo vínculo para contornar a mensagem.
Conectou, mas o tema não foi instalado	Confira a mensagem da etapa do tema. Se aparecer `ACCESS_DENIED`, revise o acesso de edição de tema do app com a Shopify ou com o suporte responsável pela integração.
Produtos não aparecem	Aguarde a sincronização; se ela falhou, confira a mensagem em Produtos e tente sincronizar após corrigir a causa.
Checkout deixou de abrir após trocar o tema	Use Reinstalar no tema publicado e repita o teste da vitrine e do carrinho.
Algum botão continua abrindo outro checkout	Identifique qual botão e qual tema apresentam o problema. Compatibilidade com botões dinâmicos e carrinhos personalizados precisa ser verificada nesse tema.

Dúvidas frequentes

Preciso copiar um token de acesso manualmente?

Você informa o domínio, Client ID e Client secret. A Fliper cuida da obtenção e renovação do token usado pela conexão.

Conectar a Shopify importa cupons ou ativa todas as funções da Shopify?

Este guia cobre conexão, catálogo e instalação no tema. Não considere cupons, bundles ou regras comerciais adicionais habilitados apenas porque a conexão foi concluída.

Desconectar na Fliper desinstala o app na Shopify?

Desconectar loja remove o vínculo e as credenciais na Fliper. A remoção do app na Shopify é feita naquele painel. A ação Remover do tema, quando disponível, trata da instalação do checkout no tema e tem efeito diferente da desconexão.

Próximos passos

Configure o frete com a Frenet e os pagamentos com a Appmax, depois valide uma compra completa.