Guia de Instalação Shopify Plugin Nativo easypay
01 set 2024
Requisitos iniciais
Se estiver a utilizar o nosso plugin antigo, deve eliminá-lo completamente para evitar conflitos com a versão nativa.
Verifique as suas configurações internas com a easypay:
- Se a sua conta de cliente está ativa;
- Se não tem endereços IP estáticos definidos no seu Backoffice easypay
(contacte o departamento de suporte da easypay); - Se tem permissões no Menu Equipas no seu Backoffice easypay.
Se tiver dúvidas sobre as configurações, deve verificá-las com o departamento de suporte da easypay antes da instalação.
Passo 1
Instalação e Ativação da App Nativa (Obrigatório)
Passo 1: Aceder ao link da app da easypay
Aceda ao link https://apps.shopify.com/easypay-mbway-mb-visa e clique no botão “Instalar na sua loja Shopify”. 
Passo 2: Confirmar instalação dentro da Shopify
Após ser redirecionado para a sua loja Shopify, clique novamente no botão “Instalar” para confirmar a instalação da app.
Passo 3: Configuração da App da easypay
Após a instalação, será redirecionado para a app e-commerce da easypay. Aqui, deve inserir o ID e a Chave da API no bloco dedicado à easypay.
Se não sabe como criar chaves API, consulte o guia oficial em como gerar chaves de autenticação.
Passo 4: Validação das Chaves API
Após inserir as chaves API, clique em “Corrigir” para validar as chaves.
Passo 5: Finalizar Instalação
Após a validação bem-sucedida, clique no botão “Finalizar Instalação no Shopify”. Será redirecionado novamente para a sua loja Shopify, onde deverá ativar a app.
Passo 2
Instalação Opcional (Integração Avançada)
Esta etapa é opcional, mas permite acesso a funções nativas do Shopify e comunicação avançada entre o Shopify e o backoffice da easypay.
Feita esta ligação automaticamente terá estas funcionalidades (ao nível da encomenda):
- As encomendas criadas serão actualizadas com Métodos de Pagamento (com as TAGS Shopify)
- Detalhes do Multibanco irão para os “Detalhes Adicionais” das encomendas (quando é o meio de pagamento Multibanco)
- No e-Commerce aparecerá o número da encomenda da loja shopify (ex #1234)
Passo 1: Verificação da Ativação da App na easypay
Na plataforma e-commerce da easypay, no bloco “Shopify”, clique no botão “Gerir no Shopify”. Dentro do Shopify garanta que a app está ativa e clique em “Save”.
Passo 2: Acesso ao Menu de Apps no Shopify
Na sua loja Shopify, aceda ao menu Apps and sales channels > Clique em “Develop apps” e, em seguida, “Create an app”. 
Passo 3: Criar Nova App
No modal que abrir, dê um nome à aplicação e clique em “Create app” para concluir.
Passo 4: Configuração da API
Clique na aba Configuration e, no bloco “Admin API integration”, selecione “Configure”.
Passo 5: Definições de Permissões
Pesquise por “Orders” na barra de pesquisa e marque as permissões write_orders e read_orders e carregar no save.
Passo 6: Obter Credenciais da API
Vá até à aba API credentials, copie e guarde os seguintes valores::
•Admin API access token
•API secret key
Após serem geradas as chaves, clique no botão Install App.
Passo 7: Inserção das Credenciais na easypay
Retorne à página e-commerce da easypay e adicione os valores copiados nos campos “Token de acesso da API Admin” e “Chave secreta da API”.
No final da página, clique em “Gravar”. Se tudo estiver correto, será exibida a mensagem “Ligação concluída com sucesso”.
Seguindo todos os passos deste tutorial, a sua loja Shopify estará corretamente integrada com a easypay, garantindo o funcionamento de todas as funcionalidades de pagamento oferecidas pela easypay.