voltar

Manual Prestashop 1.7.X.X

30 ago 2023

Requisitos do módulo easypay

  1. Garanta que tem a versão 1.7.8.6 do PrestaShop ou outra mais atualizada (este guia apresenta prints de PrestaShop 8.1.4).
  2. Verifique se estão reunidos os requisitos base para que o PrestaShop e respetivos módulos funcionem corretamente. Poderá fazê-lo através deste link: https://devdocs.prestashop.com/1.7/basics/installation/system-requirements/
  3. Ative a extensão: “curl” no PHP.

Instalação

  1. Descarregue o ficheiro “trieasypay.zip” e aceda ao BackOffice do PrestaShop.
  2. No BackOffice, na categoria “Módulos”, clique em “Module Manager”. Nesta página, no canto superior direito encontrará o seguinte botão: “Enviar um módulo”, clique aqui.
  3. Arraste o ficheiro que descarregou inicialmente,“trieasypay.zip”, e aguarde que seja concluída a instalação do Software. Assim que a mesma se encontrar finalizada, aparecerá a mensagem que se encontra na seguinte imagem:

Configuração

  1. Aceda ao Backoffice do PrestaShop, na categoria “Módulos”, clique em “Module Manager” e na barra de pesquisa escreva “easypay”. De seguida, clique no enter do seu teclado.
  2. Irá aparecer-lhe um destaque da EASYPAY, clique em “Configurar”, conforme indica a imagem:
  3. Deverá encontrar diversos campos passíveis de configuração:
    1. Ativar ambiente de testes: permite testar o módulo antes deste entrar em produção. Selecione a opção que deseja.
    2. Autorização e Captura automática: Se esta opção se encontrar ativa, o EASYPAY realiza a retenção automática dos pagamentos. Caso contrário, os pagamentos deverão ser capturados manualmente através do BackOffice. (Mais à frente neste guia de utilização, encontra-se detalhado como capturar manualmente um pagamento).
    3. Número de dias que cada método de pagamento deve ficar guardado
      – Pagamento Frequente: se o utilizador optar por guardar os seus dados de pagamento, estes deverão ficar guardados o número de dias configurado neste campo (insira um número inteiro).
    4. API ID: Inserção do ID da API da easypay. Encontra este dado no BackOffice da easypay em: “Web Services” -> ”Configuração API 2.0”. Clique no botão “Chaves”.
    5. API KEY: campo para escrever a sua KEY da API da easypay. Encontra este dado no BackOffice da easypay em: “Web Services- > “Configuração API 2.0”. Clique no botão “Chaves”.
    6. Ativar VISA: Ativação/desativação do método de pagamento “VISA”.
    7. Montante Mínimo para pagamentos frequentes com VISA/MasterCard: Indicação do valor mínimo requerido de encomenda para permitir pagamentos frequentes com VISA.
    8. Montante máximo para pagamentos frequentes com VISA/MasterCard: Indicação do valor máximo requerido de encomenda para permitir pagamentos frequentes com VISA/MasterCard.
    9. Ativar Multibanco: Ativação/desativação do método de pagamento por Multibanco.
    10. Data de expiração da referência Multibanco: 
Indicação do número de dias de validade da referência Multibanco. O número máximo de dias é 180 (insira um número inteiro). Caso não queira referências com validade preencha o campo com o valor por defeito 0.
    11. Montante Mínimo para pagamentos frequentes com Multibanco: Indicação do valor mínimo requerido de encomenda para permitir pagamentos frequentes com Multibanco.
    12. Montante máximo para pagamentos frequentes com Multibanco: Indicação do valor máximo requerido de encomenda para permitir pagamentos frequentes com Multibanco.
    13. Ativar MBWAY: Ativação/desativação do método de pagamento por MBWAY.
    14. Montante Mínimo para pagamentos frequentes com MBWAY: Indicação do valor mínimo requerido de encomenda para permitir pagamentos frequentes com MBWAY.
    15. Montante máximo para pagamentos frequentes com MBWAY: Indicação do valor máximo requerido de encomenda para permitir pagamentos frequentes com MBWAY.
    16. Ativar Débito Direto: Ativação/desativação do método de pagamento por Débito Direto.
    17. Montante Mínimo para pagamentos frequentes com Débito Direto: Indicação do valor mínimo requerido de encomenda para permitir pagamentos frequentes por débito direto.
    18. Montante máximo para pagamentos frequentes com Débito Direto: Indicação do valor máximo requerido de encomenda para permitir pagamentos frequentes por débito direto.
    19. GENERIC LINK: Copie este URL e aceda ao BackOffice da easypay, nomeadamente: “Web Services” -> “Configuração API 2.0”, clique no botão “Notificações”, seguidamente, insira o URL no campo “Generic – URL”.
    20. VISA DETALHE: Copie este URL e aceda ao BackOffice da easypay, nomeadamente: “Developers” – > “Configuração API 2.0”, clique no botão “Notificações”, seguidamente, insira o URL no campo “Card Details URL
      (Visa Details) – URL”.
    21. FRENTE VISA: Copie este URL e aceda ao BackOffice da easypay, nomeadamente “Developers” – > “Configuração API 2.0”, clique no botão “Notificações”, seguidamente, insira o URL no campo “Card Redirect (Visa Details) – URL”.

Capturar pagamentos manualmente

  1. Configure o módulo conforme explicado no ponto anterior e desative a opção
    “Autorização e Captura Automática”.
  2. Deverá esperar que seja realizada uma nova encomenda e que o cliente ative o método de pagamento no GATEWAY da easypay. (Igualmente, caso aconteça um novo pagamento por VISA).
  3. Aceda ao Backoffice do PrestaShop, à categoria “MAIS” → “Autorizar
    Pagamentos – EASYPAY”.
  4. Verifique se existem pagamentos em espera e clique no botão que corresponde à forma como pretende avançar: “Capturar Pagamento” ou “Cancelar Pagamento” .

Criar produtos de subscrição

  1. Para usar o método de pagamento por subscrição deverá configurar o módulo e ativar o método de pagamento “Débito Direto”.
  2. Deverá criar um novo produto/serviço configurado, por forma a ser um produto de subscrição:
    1. Aceda ao BackOffice do Prestashop: “Catálogo”→ “Produtos” e clique no botão “Novo Produto”.
    2. Preencha as configurações Default do PrestaShop para criar um produto: 

    3. No final da página selecione as categorias que vão definir onde será exibido o produto, adicione uma nova categoria “Subscrições” (esta é de seleção obrigatória e será previamente criada de forma automática pelo módulo EASYPAY durante a instalação). 

      A “Categoria principal” precisa de ter selecionado “Subscrições”  

    4. Nas funcionalidades do produto deve, no primeiro campo designado “Característica”, adicionar “Frequência”, e no campo “Valor Pré- definido” selecione a frequência com que o valor a ser cobrado ao cliente irá acontecer. Um exemplo prático: se selecionar “1M” e o valor da subscrição corresponder a “12.3€”, então todos os meses e de forma automática, será cobrado ao cliente o valor “12.3€” até que a subscrição do produto/serviço seja cancelada ou o período de subscrição acabe.
    5. Nas funcionalidades, adicione uma nova, e selecione “tempo de subscrição”. Esta opção vai indicar o tempo máximo da subscrição, deixando a mesma de estar válida após o período definido. Se selecionar “Ate cancelar subscrição” módulo vai continuar a renovar a subscrição na frequência previamente definida até que o utilizador ou comerciante cancelem manualmente respetiva subscrição.
  3. Para cancelar qualquer subscrição ativa (COMERCIANTE) aceda ao BackOffice do PrestaShop: “MAIS” →  “Subscrições Ativas – EASYPAY”, onde encontrará a(s) subscrição(ões) que pretende cancelar. De seguida, clique no botão “Cancelar Subscrição”.
  4. Para cancelar uma subscrição ativa (UTILIZADOR) deve ir a “Encomendas” (A localização no FrontOffice depende do Template utilizado), aceder ao método de pagamento por subscrição e clicar em “Detalhes”. Exibidos todos os detalhes, encontra um botão para cancelar a subscrição entre as moradas e a listagem de produtos (Esta informação pode variar consoante a configuração do FrontOffice do comerciante).