Para iniciar a integração completa da sua loja com a plataforma e deixá-la pronta para vender, é importante primeiro entender a arquitetura da integração. Assim, você saberá exatamente por onde começar e quais etapas seguir durante a configuração.
Abaixo, você encontrará uma imagem demonstrando o fluxo integração e os primeiros passos do processo.
Este é o fluxo da integração: primeiro, você deve integrar a Bestfy ao checkout da Luna. Após concluir essa etapa, será necessário realizar a integração da Luna com a Shopify para finalizar a configuração da operação.
⚙️ Credenciais de API na Bestfy
1. Acesse o menu de "Configurações" dentro do dashboard da Bestfy.
2. Em “Credenciais de API”, copie sua chave secreta.
3. Copie e salve a chave secreta em um local seguro, como um bloco de notas. Ela será necessária para concluir a integração com a Luna Checkout no próximo passo.
⚙️ Integrando na Luna Checkout
1. No painel da Luna Checkout, role até o final do menu lateral e clique em “Configurações”.
2. No menu configurações, clique em "Gateways".
3. Agora, localize ou utilize a barra de busca para encontrar a opção "Bestfy V2".
4. Neste passo, será necessário inserir chave secreta em API Key e alterar o status para “Ativo”, e ao final da página clique em "Salvar".
5. Pronto! Após concluir essa etapa, a Bestfy estará integrada à Luna Checkout. Agora, seguiremos para o próximo passo: a integração do checkout com a Shopify.
⚙️ Integrando na Shopify
1. Acesse o painel de "Configurações" dentro de sua Shopify que fica no canto inferior esquerdo da sua tela.
2. Após isso, acesse a opção “Apps” no menu.
3. Clique em “Desenvolver apps” no canto superior direito da tela.
4. Em “Desenvolvimento de apps”, clique na opção “Desenvolver apps no Dev Dashboard”.
5. Em sua Dev Dashboard clique em ”Criar app”.
6. Neste passo, defina um nome para o app. Como sugestão, utilize “Luna Checkout” para facilitar a identificação e organização da integração.
7. Em URL's, copie a URL abaixo e cole em URL do app. E desmarque a opção de "incorporar app no admin da Shopify".
8. Em “Acesso”, cole exatamente os escopos informados abaixo.
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
⚠️Atenção: copie e cole exatamente como está acima, qualquer permissão incorreta ou faltante impedirá a conclusão da instalação.
9. Em URL's de redirecionamento, copie a URL abaixo e insira como mostrado na imagem.
10. Role até o final da página e clique em “Lançar”.
⚠️Atenção: nenhuma configuração deve ser realizada nas seções “POS” ou “App Proxy”. Caso qualquer alteração seja feita nessas áreas, o aplicativo poderá não funcionar corretamente.
11. Uma janela de confirmação será exibida, solicitando o nome do aplicativo e uma mensagem opcional. Após preencher as informações, clique em “Lançar”.
12. Pronto! Seu aplicativo já está configurado e pronto para ser ativado na Shopify.
Agora, na etapa final, será realizada a integração com a Luna Checkout para concluir toda a configuração da operação.
✅ Finalizando a Integração
Nestes últimos passos, será necessário conectar o app criado na Shopify à Luna Checkout para finalizar a integração da operação.
1. No menu lateral clique em "Configurações".
2. Copie o ID do cliente e a chave secreta em um local seguro, como um bloco de notas. Ela será necessária para concluir a integração no próximo passo.
⚠️ Atenção: esta é uma chave única e restrita. Não compartilhe com terceiros.
3. Acesse o painel da Luna Checkout e vá na opções de App's.
4. Agora, acesse o menu da Shopify clicando no ícone de lápis.
5. Neste passo, será necessário preencher três informações para prosseguir com a integração. A URL da loja Shopify, o ID do cliente e chave secreta.
Domínio
Insira o domínio gerado automaticamente pela própria Shopify. Você pode localizá-lo em “Configurações → Domínios”.
⚠️Atenção: é obrigatório utilizar o domínio aleatório gerado pela Shopify. Caso outro domínio seja preenchido, a integração poderá falhar.
ID do cliente e chave secreta
Essa informação foi obtida no passo 2 desta mesma seção.
Ao final, as informações deverão estar preenchidas na Luna Checkout conforme o exemplo abaixo.
6. Role um pouco a página para baixo e clique em “Salvar”.
7. Você será redirecionado para a página da Shopify, onde poderá confirmar a conexão da sua loja. Após clicar em “Instalar”, o sistema realizará o redirecionamento automático de volta para a Luna Checkout.
8. Para finalizar, clique nas setas de sincronização para sincronizar os produtos e o tema da loja.
9. Pronto! Sua operação está integrada e preparada para começar a vender utilizando Bestfy, Luna Checkout e Shopify.
📌Considerações Finais
Após concluir a integração, algumas sincronizações podem levar alguns minutos para serem refletidas entre a Shopify e a Luna Checkout
Produtos recém-criados ou atualizados podem precisar de uma nova sincronização manual para refletirem corretamente no checkout.
Antes de iniciar tráfego ou escalar campanhas, faça pedidos de teste para validar toda a jornada de compra da operação.
Caso utilize aplicativos adicionais na Shopify, valide se eles não interferem no funcionamento do checkout ou na estrutura do tema.
Recomendamos manter os acessos administrativos da Shopify e da Luna Checkout organizados e restritos apenas aos responsáveis pela operação.
Para garantir maior estabilidade, evite remover permissões ou alterar configurações do aplicativo após a integração concluída.
Sempre que realizar alterações importantes no tema da loja, recomendamos validar se o checkout continua funcionando corretamente.