Como instalar o Checkout da Umpi na Shopify?
Pra instalar o checkout da Umpi em sua loja Shopify, é necessário seguir esses passos:
Passo 1 - Criar o app personalizado; |
Passo 2 - Configurar os escopos (permissões) do App; |
Passo 3 - Instalar o aplicativo e obtenha os tokens de acesso à API; |
Passo 4 - Instalar o Checkout. |
Passo 1 - Criar o App privado
1. Acesse o painel administrativo da Shopify;
2. Na barra de pesquisa, clique em “Apps” → “Configurações do Apps e dos canais de venda”;
3. Clique em “Desenvolver apps”.
4. Clique “Criar um app”.
⚠️ Se está criando um app pela primeira vez, é necessário "Permitir o desenvolvimento de apps personalizados" na tela a seguir.
5. Preencha os campos a seguir. Em seguida, clique em ''Criar app''.
Nome do App: Você pode colocar o nome que preferir. Sugestão: Checkout Umpi
Desenvolvedor do app: Selecione o usuário que deseja atribuir a função. O desenvolvedor do aplicativo pode ser o proprietário da loja ou qualquer conta de equipe ou colaborador com a permissão Desenvolver aplicativos.
Passo 2 - Configurar os escopos (permissões) do App.
1. Clique em "Configurar escopos do API Admin";
2. Selecione os escopos (permissões) de API abaixo. Lembre-se de liberar todas as permissões, permissões incorretas podem causa incompatibilidade na integração;
3. Clique em "Salvar".
Passo 3 - Instalar o aplicativo e obtenha os tokens de acesso à API
1. Vá em "Credenciais de API”→ "Instalar App";
2. Você receberá suas credenciais de acesso à API, que deverão ser utilizadas no próximo passo.
⚠️ Atenção: O Token é revelado apenas uma vez. Ele concede acesso à API para dados confidenciais da loja. Após revelar o token de acesso, anote ou registre o token em algum lugar seguro para que você possa consultá-lo novamente.
Passo 4 - Instalar o Checkout
1. Acesse: "Integrações" → "Shopify" → "Instalar";
2. Preencha os campos a seguir.
📌Importante saber: No campo ''URL da loja'' você precisa inserir a URL original da sua loja, pois a URL incorreta pode gerar incompatibilidade de credenciais.
Acesse "Configurações" → "Domínios" → Copie o domínio original.
SOLUÇÃO DE PROBLEMAS
Fiz todo o procedimento e mesmo assim o checkout não funciona.
Verifique se o seguinte script está inserido no theme.liquid
<!-- Don't Remove this code. umpi App code. -->
{% capture umpi_snippet_content %}{% include 'umpiCheckout' %}{% endcapture %}
{% unless umpi_snippet_content contains 'Liquid error' %} {% include
'umpiCheckout' %} {% endunless %}
<!-- Don't Remove this code. umpi App code. -->
Caso não esteja, copie, cole no final do arquivo e salve.