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 Zedy. Após concluir essa etapa, será necessário realizar a integração da Zedy 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 Zedy Checkout no próximo passo.
⚙️ Integrando com a Zedy Checkout
1. No painel da Zedy Checkout, clique em "Gateways".
2. Agora, localize a opção "Bestfy V2".
3. Insira a chave secreta fornecida e a taxa de parcelamento previamente acordada com a Bestfy. Logo abaixo, escolha a opção de processar cartão de crédito ou PIX, conforme sua operação.
⚠️ Atenção: Não selecione a opção "juros customizados por parcela".
4. Em "Status de Integração", selecione a opção "Ativo" e, ao final da página, clique em "Ativar Integração".
5. Pronto! Após concluir essa etapa, a Bestfy estará integrado à Zedy Checkout e pronto para transacionar normalmente.
⚙️ 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 “Zedy 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_customers, write_customers, read_orders, write_orders, read_products, write_products, read_themes,write_themes, read_discounts, read_price_rules
⚠️Atenção: copie e cole exatamente como está acima, qualquer permissão incorreta ou faltante impedirá a conclusão da instalação.
9. Role até o final da tela e clique em “Lançar”. Uma nova janela será exibida. Não é necessário preencher nenhuma informação, basta clicar novamente em “Lançar” para continuar.
✅ Finalizando a Integração
Nestes últimos passos, será necessário conectar o app criado na Shopify à Zedy 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. No painel da Zedy Checkout, clique em "Apps".
4. Em plataformas selecione "Shopify".
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 Zedy 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 Zedy Checkout.
9. Pronto! Sua operação está integrada e preparada para começar a vender utilizando Bestfy, Zedy Checkout e Shopify.
📌Considerações Finais
Após concluir a integração, algumas sincronizações podem levar alguns minutos para serem refletidas entre a WooCommerce e a Zedy 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 WooCommerce, valide se eles não interferem no funcionamento do checkout ou na estrutura do tema.
Recomendamos manter os acessos administrativos da WooCommerce e da Zedy 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.