voltar

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.