Passar para o conteúdo principal

Como configurar o Checkout da Luna na Shopify?

Como instalar o Checkout Transparente da Luna na sua loja Shopify (passo a passo).

Escrito por Luna Checkout

A Shopify é uma plataforma de lojas virtuais, com diversos recursos disponíveis, incluindo a possibilidade de integrar o Checkout Transparente da Luna. Com ele, sua loja passa a contar com uma solução líder no mercado nacional, aumentando as taxas de conversão e proporcionando uma experiência de compra mais fluida e eficiente no momento mais decisivo da jornada do cliente.

Nesse artigo, vamos mostrar como funciona a integração e todo o passo a passo pra você configurar o Checkout em sua loja da Shopify .

Como funciona a integração Luna + Shopify?

A Luna será o Checkout da sua loja, ou seja: A partir do momento de instalação, o checkout nativo da sua loja será substituído pelo Checkout da Luna, e os pedidos serão realizados através da nossa página de finalização.

A integração pode:

  • Receber Produtos (Apenas recebemos do Shopify, não enviamos);

  • Enviar Pedidos (Apenas enviamos os pedidos para lá, não recebemos);

  • Receber atualizações de rastreio;

  • Receber atualizações de preço e alteração dos produtos;

  • Alterar o estoque do produto na sua loja (Opcional);

  • Aplicar descontos e promoções dentro do nosso checkout que foram criados na shopify (Opcional);

Como instalar o Checkout da Luna na Shopify?

⚠️ Para integrar a Luna a sua shopify, sua conta da Luna e sua loja Shopify devem estar logadas no mesmo navegador, caso não esteja, a integração dará erro no momento da autenticação.

Pra instalar o checkout da Luna em sua loja Shopify, é necessário seguir esses simples passos:

Passo 1 - Criar ou acessar sua conta no Shopify Partners

Passo 2 - Criar o app no Dev Dashboard da Shopify

Passo 3 - Configurando a "Distribuição" do app (Distribution)

Passo 4 - Conectar com a Luna (Client ID + Secret)

Passo 5 - Sincronizar produtos e tema

Passo 1 - Criar ou acessar sua conta no Shopify Partners

Para realizar a integração do Checkout da Luna em sua loja Shopify, é necessário criar um aplicativo em sua conta Shopify, e esse aplicativo fará a conexão necessária com nosso Checkout.

No entanto, para criar esse aplicativo e ter as configurações exigidas, você precisará acessar sua conta do Shopify Partners, uma conta exclusiva para "Parceiros Shopify" que desejam criar aplicativos dentro do seu ecossistema, entre outras coisas.

Se você nunca acessou ao painel Shopify Partners, não se preocupe: é super rápido e simples. E claro, mostramos tudo detalhado cada etapa que precisará seguir.

  1. Primeiramente, acesse a página Shopify Partners e clique em "Fazer Login", no canto superior direito.

  2. Se você já possui uma conta, será direcionado para inserir e-mail e senha. Caso ainda não possua, o próprio sistema identifica e inicia então um rápido cadastro.

    Abaixo, deixaremos as perguntas de cada etapa e qual opção deverá selecionar:

    1. Como você quer começar como Parceiro?

      Escolha a opção: Criar e configurar uma nova organização Parceira

    2. Qual é seu principal foco como Parceiro da Shopify?

      Criação de Apps

    3. Onde sua empresa está localizada?

      Selecione "Brazil" e, na opção abaixo, o estado.

    4. Adicione informações de contato da empresa

      Aqui você só precisará preencher rapidamente algumas informações da sua empresa.

    5. Clique em "Criar organização Parceira".

  3. Em seu painel do Shopify Partners, no menu lateral esquerdo, clique em "Distribuição de apps → Todos os apps".

  4. Clique em "Visitar o Dev Dashboard".

Passo 2 - Como acessar o Dev Dashboard da Shopify

  1. Acesse o painel de configurações dentro de sua Shopify que fica no canto inferior esquerdo da sua tela;

  2. No menu lateral clique em Apps;

  3. Clique em “Desenvolver apps”.

  4. Clique “Desenvolver apps no Dev Dashboard”.

Passo 2 - Instalar o app

  1. Em sua dev dashboard clique em Create app;

2. Em Start from Dev Dashboard, dê um nome ao app. Sugestão Luna Checkout;

3. Clique em Create”.

URLs

4. Em URLs, copie a URL abaixo e cole em App URL.

5. Desmarque a opção “Embed app in Shopify admin”:

Access

6. Em “Access”, cole o trecho abaixo no campo "Scopes".

read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_custom_fulfillment_services,write_custom_fulfillment_services,read_price_rules,read_discounts,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_orders,write_orders,read_products,write_products,read_themes,write_themes,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_inventory,write_inventory

⚠️ Copie e cole exatamente como está acima, qualquer permissão incorreta ou faltante impedirá a conclusão da instalação.

7. Cole o link abaixo no campo "Redirect URLs".

8. Role até o final da tela e clique em “Release”.
Uma janela vai abrir: não é necessário preencher nada. Clique novamente em “Release”.

⚠️ Importante

Nada deve ser configurado em POS ou App Proxy. Se qualquer uma dessas áreas for alterada, o app pode não funcionar corretamente.

Passo 3 - Configurando a "Distribuição" do app (Distribution)

Assim que você finaliza a etapa anterior clicando em "Release", o seu app está criado, mas ainda faltam algumas etapas para finalizar a instalação.

Nessa tela inicial do painel Dev Dashboard, após clicar em "Release" você estará dentro as configurações do App que criou. Agora basta seguir as etapas abaixo, seguindo atentamente cada orientação.

  1. Clique no nome do app (primeira opção) no menu da esquerda que acabou de criar para acessar a página incial.

  2. Localize a opção "Distribution" e clique em "Selecionar forma de distribuição".

  3. Ao clicar nessa opção, você será levado novamente para o painel do Shopify Partners.

  4. Clique em "Distribuição personalizada" e confirme.

  5. Será solicitado o domínio da sua loja, mas atenção: Você deve inserir o domínio raiz da Shopify que termina com .myshopify.com, que seria o domínio raiz entregue pela Shopify.

    Como encontrá-lo:

    1. Acesse seu painel da Shopify, em: https://admin.shopify.com/

    2. Clique em "Configurações" no canto inferior esquerdo, e depois em "Domínios".

    3. Copie o domínio raiz/primário que foi gerado ao criar a conta na Shopify. Esse domínio é geralmente assim: lczexemplo.myshopify.com


      📌Atenção: É aceito no preenchimento somente o domínio raiz da Shopify, domínios comprados e demais derivações do domínio da Shopify não são aceitos.

  6. Volte para a tela do "Partners Shopify" e cole o domínio.

  7. Clique em "Gerar link".

  8. Uma tela de "Distribuição" será aberta com um link para ser copiado. Clique no botão "Copiar".

  9. Abra uma nova guia em seu navegador, cole o domínio que acabou de copiar e aperte a tecla "Enter" em seu teclado.

  10. Assim que selecionar a loja para iniciar a instalação, aparecerá uma tela de confirmação da instalação: clique em "Instalar".

Passo 4 - Conectar com a Luna (Client ID + Secret)

Ao terminar o passo 3 você será redirecionado para o site da Luna, pode fechar essa aba e voltar para a sua dev dashboard da Shopify.

  1. No menu lateral clique em Settings“.

2. Copie Client ID e Secret

3. Acesse sua conta na Luna, e clique em Apps->Shopify

🌙 Se quiser personalizar seu App e deixa-lo visualmente mais bonito na shopify siga os seguintes passos:

  1. Em settings na mesma tela onde pegou as credenciais, role a tela toda para baixo e clique em upload icon

  2. Baixe o Icone no link abaixo e faça o upload dele.

4. Para a URL da loja shopify, dentro da sua conta na shopify acesse Configurações -> Domínios

5. Copie a URL aleatória gerada pela shopify, exemplo de como seu domínio aparecerá: fb1jed-yn.myshopify.com

⚠️ Importante

Precisa ser obrigatoriamente esse domínio aleatório, se preenchido com outro domínio a integração falhara.

Dentro da luna deve ficar assim:

Rolando a tela para baixo você tem 2 regras que são opcionais da sua integração com a shopify, que são:

Pular carrinho: Pula o carrinho da sua loja e vai direto para o checkout;


Atualizar estoque: escolha se a cada venda de um produto seu a Luna deve diminuir o estoque desse produto em sua loja shopify.

6. Clique em salvar

7. Clique em sincronizar Produto e sincronizar Tema.

🎉 Pronto! O Checkout da Luna já está ativo em sua loja Shopify!

Respondeu à sua pergunta?