---
title: Manual de instalação do plugin easypay com o WooCommerce
description: Saiba como integrar o plugin da easypay com o seu WooCommerce - manual de instalação.
---

[Ignorar para conteúdo](https://support.easypay.pt/knowledge-base/manual-de-integração-do-plugin-easypay-com-o-woocommerce#main-content)

- [Português - Portugal](https://support.easypay.pt/knowledge-base/manual-de-integra%C3%A7%C3%A3o-do-plugin-easypay-com-o-woocommerce)
- [Espanhol](https://support.easypay.pt/es/knowledge-base/manual-de-integração-do-plugin-easypay-com-o-woocommerce)
- [Inglês](https://support.easypay.pt/en/knowledge-base/manual-de-integração-do-plugin-easypay-com-o-woocommerce)

Português - Portugal

Mostrar submenu para traduções

[Abrir um ticket](https://support.easypay.pt/knowledge-base/kb-tickets/new?hsLang=pt-pt)

[![logotypes](https://support.easypay.pt/hubfs/logotypes.svg)](https://www.easypay.pt/)

Abrir navegação principal

Fechar navegação principal

- - [Português - Portugal](https://support.easypay.pt/knowledge-base/manual-de-integra%C3%A7%C3%A3o-do-plugin-easypay-com-o-woocommerce)
    - [Espanhol](https://support.easypay.pt/es/knowledge-base/manual-de-integração-do-plugin-easypay-com-o-woocommerce)
    - [Inglês](https://support.easypay.pt/en/knowledge-base/manual-de-integração-do-plugin-easypay-com-o-woocommerce)

  Português - Portugal
  
  Mostrar submenu para traduções
- [Abrir um ticket](https://support.easypay.pt/knowledge-base/kb-tickets/new)
- [Abrir um ticket](https://support.easypay.pt/knowledge-base/kb-tickets/new?hsLang=pt-pt)

[Abrir um ticket](https://support.easypay.pt/knowledge-base/kb-tickets/new?hsLang=pt-pt)

 Suporte easypay

- Não existem sugestões porque o campo de pesquisa está vazio.

1. [Knowledge base](https://support.easypay.pt/knowledge-base?hsLang=pt-pt)
2. [Soluções](https://support.easypay.pt/knowledge-base/solu%C3%A7%C3%B5es?hsLang=pt-pt)

# Manual de instalação do plugin easypay com o WooCommerce

Para integrar a easypay com o WooCommerce, instale o [plugin](https://wordpress.org/plugins/easypay-gateway-checkout-wc/) e siga os passos do Manual abaixo:

#### 1. Login E-commerce

Faça login na plataforma E-commerce da easypay, utilizando as mesmas credenciais de acesso (email e password) ao seu backoffice.  
[https://e-commerce.easypay.pt/](https://e-commerce.easypay.pt/)  
![](https://www.easypay.pt/wp-content/uploads/magento-tutorial-8.jpg)

**Alternativamente** poderá sempre aceder a este menu da seguinte forma:

Login no BackOffice da easypay \> selecionar a opção “Apps” \> no final, basta clicar em no botão E-commerce. Será redirecionado num novo separador à  plataforma eCommerce da easypay.![](https://www.easypay.pt/wp-content/uploads/woocommerce-tutorial-1.jpg)

#### 2. Criar Loja na plataforma e-commerce

Neste menu irá criar a sua ligação à loja WooCommerce.

#### 2.1. Criar Loja

Para criar a sua loja, deverá clicar no botão “+ Criar Loja” e preencher os dados do formulário apresentado.

Se tiver mais do que uma loja, terá de repetir o processo, para quantos domínios tiver.

![](https://www.easypay.pt/wp-content/uploads/manual-woocommerce-2.png)

#### 2.2. Preenchimento de dados para Criação da Ligação à Loja

![](https://www.easypay.pt/wp-content/uploads/image7.jpg)

**Dados a Preencher:**

**Tipo de Loja:** Woocommerce  
**Nome:** Nome da sua Loja  
**Domínio:** URL da completo. Ter em atenção que deverá sempre retirar esta informação na seguinte opção em BackOffice (WordPress) Opções \> Geral \> **copiar** o Endereço do site (URL) Nota: **Não escrever o URL manualmente.**

![](https://www.easypay.pt/wp-content/uploads/image8.jpg)

[easypay: Chaves da easypay (ID da conta + Chave da API): **Ver o passo 3.1**](https://support.easypay.pt/knowledgebase/como-gerar-chaves-de-autentica%C3%A7%C3%A3o)** –  Neste passo vai gerar as chaves da easypay (antes de fazer gravar a loja).**

#### 3. Configurações easypay e WooCommerce

#### 3.1. Configurar Easypay

Aceda ao seu Backoffice easypay e no menu **Plugins \> WooCommerce \> **Gerar chaves em**(+Nova).**  
Serão geradas as Chaves, onde consta, o ID da conta + Chave da API a configurar.

![](https://www.easypay.pt/wp-content/uploads/p7_13.png)

No final apenas terá de copiar as chaves (ID da conta + Chave da API) geradas anteriormente, e colar no Backoffice eCommerce:

![](https://www.easypay.pt/wp-content/uploads/Screenshot-2023-10-24-at-10.57.09.png)![](https://www.easypay.pt/wp-content/uploads/woo-3.0.png)

- Validar “checkbox” para que autorize a cópia automática dos URL’s de comunicação para o seu Backoffice easypay.
- Clicar em “**Gravar**”

Após este passo a sua loja será submetida a validação (prazo máximo 2 dias úteis).

**Obs: Pode continuar e terminar a integração ficando somente a funcionar após validação.**

**Após posterior validação, poderá selecionar os métodos de pagamento contratados com a easypay nesta conta.**

![](https://www.easypay.pt/wp-content/uploads/p8_15.png)

**Basta selecionar os métodos de pagamento pretendidos e fazer “Gravar Loja” (botão que se encontra no fim da página).**

![](https://www.easypay.pt/wp-content/uploads/10-2.jpg)

Notas Importantes:

- Desta forma a loja está completamente criada, **sendo apenas preciso validação da Loja por parte da easypay**, e caso não verifique esta validação num espaço de 2 dias úteis, deverá entrar em contacto com a easypay.
- É recomendável que a loja seja apenas registada na nossa plataforma e-commerce quando já existir uma loja Woocommerce criada.

#### 3.2. Configurar Woocommerce

Este ponto tem três passos para efetuar.

**1° Passo — Instalar o plugin easypay:**

Ir ao menu “Plugins” do Wordpress, escolher “Adicionar Novo Plugin”, procurar por easypay e fazer “Instalar Agora”.![](https://www.easypay.pt/wp-content/uploads/image13.jpg)

**Alternativa:** Ir diretamente ao website oficial do Wordpress ([https://pt.wordpress.org/plugins/easypay-gateway-checkout-wc/](https://pt.wordpress.org/plugins/easypay-gateway-checkout-wc/\).)), descarregar e carregar manualmente plugin.

![](https://www.easypay.pt/wp-content/uploads/Screenshot-2023-10-24-at-11.00.55.png)![](https://www.easypay.pt/wp-content/uploads/Screenshot-2023-10-24-at-11.01.08.png)

Após proceder à instalação deve **ativar** o plugin:

**Ou em alternativa**, activar o plugin “**Checkout de Pagamentos easypay para WooCommerce**” na secção Plugins do WordPress. 

![](https://www.easypay.pt/wp-content/uploads/image16.jpg)

Neste passo vamos terminar a configuração do plugin clicando em **Configurações** ou no menu do lado esquerdo em **WooCommerce \> easypay.**

![](https://www.easypay.pt/wp-content/uploads/image17.jpg)

**OBS**: No caso do plugin **não aparecer** no menu de pagamentos deve aceder em **Backoffice WooCommerce \> Plugins **e no filtro** “Inativos”, **encontrar o “**Checkout de Pagamentos easypay para WooCommerce**” e **ativar**.

![](https://www.easypay.pt/wp-content/uploads/image18.jpg)![](https://www.easypay.pt/wp-content/uploads/image19.jpg)

**2º Passo – Configurar o plugin easypay.**

![](https://www.easypay.pt/wp-content/uploads/image20.jpg)

- Chave de Ligação: irá colar a chave da ligação proveniente da plataforma eCommerce easypay (explicado em detalhe no próximo passo)
- Sandbox easypay: poderá usar o plugin em modo sandbox, no entanto, terá de criar uma ligação na plataforma eCommerce easypay de sandbox e terá de passar pelo mesmo processo de validação. **(Apenas deve estar ativo se realmente pretender utilizar o modo de testes)**
- Meios de Pagamentos separados:  
    - Se estiver ativo, os meios de pagamentos contratados irão aparecer ao utilizador em separado, dessa forma podem escolher o meio de pagamento para efetuar a compra.

**Exemplo:**

![](https://www.easypay.pt/wp-content/uploads/image21.jpg)![](https://www.easypay.pt/wp-content/uploads/image22.jpg)

- - Se estiver desativado, os meios de pagamento aparecem para escolha no checkout da easypay e assim os clientes só fazem uma escolha dos meios de pagamento.  
      **Exemplo**:  
      ![pastedGraphic.png](https://support.easypay.pt/hs-fs/hubfs/undefined.png?width=314&height=25&name=undefined.png)  
      ![](https://www.easypay.pt/wp-content/uploads/image24.jpg)

![](https://www.easypay.pt/wp-content/uploads/image23.jpg)

**Nota:**  
Com esta opção ativa também estará disponível a possibilidade de alterar o logotipo apresentado por defeito, podendo ser descarregados em: [**https://www.easypay.pt/brand-center/**](https://www.easypay.pt/brand-center/)

![](https://www.easypay.pt/wp-content/uploads/image25.jpg)

- Apresentação do checkout:  
    - Inserido na página – Aparece embebido na página do WooCommerce de Pagamento da easypay.

![](https://www.easypay.pt/wp-content/uploads/image26.jpg)

- - Popup – Aparece um botão para pagar na página do WooCommerce de Pagamento da easypay e ao clicar irá abrir o checkout da easypay em popup. 
          - Esta funcionalidade abrirá o checkout de pagamento em popup.
          - Se for fechado tem um botão “Pague Agora” que é estilizado automaticamente pelo template utilizado.
          - Esta funcionalidade é aconselhada para quando há a necessidade de ter conteúdo por trás sem ter o checkout diretamente a ocupar espaço na página. 

Nota: Não aparece como popup na página de Finalizar compra mas sim na página de checkout.

![](https://www.easypay.pt/wp-content/uploads/image27.jpg)

- Detalhes do Pagamento:  
    - Ocultar Detalhes – Se estiver esta opção selecionada, o utilizador não irá ver a janela das suas informações no checkout da easypay (não terá de fazer dois cliques para efetuar o pagamento). No entanto, se o utilizador não preencheu alguns dos campos obrigatórios, o passo 1 dos detalhes irá aparecer.

![](https://www.easypay.pt/wp-content/uploads/image28.jpg)

- - Mostrar Detalhes – Se estiver esta opção selecionada, o utilizador irá ver um resumo das suas informações.

![](https://www.easypay.pt/wp-content/uploads/image29.jpg)

- Configurações dos Pagamentos: Aqui encontra-se o link direto para ativar o desativar os meios de pagamento no WooCommerce. **Nota: Certifique-se que os meios de pagamento easypay que pretende estão ativos.**

![](https://www.easypay.pt/wp-content/uploads/image30.jpg)

 **3º Passo – Gerar a Chave de Ligação**

No eCommerce da plataforma easypay, deve **Copiar** / **Gerar Chave** e colar no plugin easypay WooCommerce no campo “Chave de Ligação”.

Plataforma eCommerce easypay:

![](https://www.easypay.pt/wp-content/uploads/image31.jpg)

Plugin WooCommerce easypay:

![](https://www.easypay.pt/wp-content/uploads/image32.jpg)![](https://www.easypay.pt/wp-content/uploads/image33.jpg)

#### 3. Configurar API WooCommerce

Configurar e validar o Consumer Key e Consumer Secret da API do WooCommerce. Isto permite que a easypay comunique com a sua loja WooCommerce.

No seu WordPress, no menu WooCommerce \> Configurações \> Avançado \> API REST:

![](https://www.easypay.pt/wp-content/uploads/image34.jpg)![](https://www.easypay.pt/wp-content/uploads/image35.jpg)

- Adicionar **Chave da API REST** no Woocommerce
- Adicionar Descrição \> Selecionar Utilizador
- A configuração mais importante neste cenário é que tenha selecionado as permissões “**Leitura e Escrita**” e fazer **Gerar chave da API**.

**Por fim, basta copiar e colar as chaves nos respetivos campos, apresentados anteriormente, para a plataforma de eCommerce e fazer validar**.

![](https://www.easypay.pt/wp-content/uploads/image36.jpg)

#### 4. Página Inicial – Plataforma e-Commerce easypay

São listadas todas as ligações que tem associadas à sua conta easypay.

Facilmente poderá verificar vários tipos de informações:

- Se a loja se encontra ativa
- Se a loja se encontra verificada pela easypay
- Se a loja está com os dados válidos da easypay
- Estado da configuração do WooCommerce e da easypay

![](https://www.easypay.pt/wp-content/uploads/32.jpg)

#### 5. Personalizar estilo do Checkout – Plataforma eCommerce easypay

Pode estilizar o seu checkout final alterando as opções disponíveis na página da ligação.

#### ![](https://www.easypay.pt/wp-content/uploads/image38.jpg)

- Presets 
    - Pode escolher estilos predefinidos pela easypay
- URL Logótipo 
    - Pode colocar um URL do seu logótipo
- Língua 
    - Neste momento é definida automaticamente pelo seu Wordpress
- Esconder Detalhes 
    - Está presente nas definições do Plugin no WooCommerce
- Tipo de Letra
- Pode escolher uma font personalizada colocando o link da font.  
  Exemplo:![](https://www.easypay.pt/wp-content/uploads/image39.jpg) 
    - Todas as outras opções 
          - São estilizações que pode alterar consoante a sua personalização
    - Gravar 
          - Por fim basta clicar no botão de Gravar.

#### 6. Página Pagamentos – Plataforma eCommerce easypay ![](https://www.easypay.pt/wp-content/uploads/33.jpg)

Aqui é possível ver todas as entradas de encomendas efectuadas apenas com a easypay.

Se for usado outro método de pagamento que não easypay pelo Woocommerce, então não irá aparecer aqui neste ecrã.

É possível, de forma rápida, ver a “Data”, “Cliente”, “Montante Total”, “Métodos de Pagamento”e “Estado da Encomenda”.

Se o utilizador tiver mais que uma loja registada, poderá escolher a loja que quer consultar, como representado na figura acima.

#### 7. Informações suporte easypay:

#### 7.1. Informações para Programadores

Caso a plataforma eCommerce não valide a ligação com a API do eCommerce deve certificar-se que consegue fazer um pedido via API ao WooCommerce.  
Segue um exemplo de um teste básico que pode ser feito via Postman:

- GET a endpoint \[URL do WooCommerce\] + /wp-json/we/v3/taxes
- Autorização Básica usando o Consumer Key e Consumer Secret gerado na API do WooCommerce

Caso não devolva resultados deve validar as configurações do seu servidor ou do seu WordPress.

#### 7.2. Informações Gerais

Qualquer dúvida adicional que tenha, solicitamos que entre em contacto com a easypay.

Solicitamos sempre que nos envie um email para o [correio@easypay.pt](mailto:correio@easypay.pt). Neste email deverá ter os seguintes dados:

1. Contribuinte da empresa em questão;
2. Prints das configurações feitas até ao momento;
3. Print do erro que lhe aparece;

**URL’s de comunicação (informativo):**

[https://e-commerce.easypay.pt/webhooks/easypay/generic](https://e-commerce.easypay.pt/webhooks/easypay/generic) – (Generic – URL na easypay)

[https://e-commerce.easypay.pt/webhooks/easypay/transaction](https://e-commerce.easypay.pt/webhooks/easypay/transaction) – (Payment – URL na easypay)

[https://e-commerce.easypay.pt/webhooks/easypay/authorisation](https://e-commerce.easypay.pt/webhooks/easypay/authorisation) – (Authorisation – URL  na easypay)

[https://e-commerce.easypay.pt/webhooks/easypay/visa-fwd](https://e-commerce.easypay.pt/webhooks/easypay/visa-fwd) – (Card Redirect (Visa Fwd) – URL na easypay)

[https://e-commerce.easypay.pt/webhooks/easypay/visa-detail](https://e-commerce.easypay.pt/webhooks/easypay/visa-detail) – (Card Details URL (Visa Details) – URL na easypay)

#### 8. Configurar WooCommerce de Testes (Sandbox)

Faça login na plataforma eCommerce de testes da easypay, utilizando as mesmas credenciais de acesso (email e password) do seu Backoffice de testes da easypay.

[https://e-commerce.test.easypay.pt/](https://e-commerce.test.easypay.pt/)

Uma barra amarela irá estar presente informando que se encontra em ambiente de testes.

![](https://www.easypay.pt/wp-content/uploads/Screenshot-2023-11-21-at-12.47.29.png)

**Alternativamente** poderá sempre aceder a este menu da seguinte forma:

Login no [BackOffice de testes](https://id.test.easypay.pt/) da easypay \> selecionar a opção “Apps” \> no final, basta clicar em E-commerce.

Será redirecionado para um novo separador, eCommerce de testes da easypay.

A partir deste momento pode efetuar a configuração utilizando as das plataformas, Backoffice de testes easypay e eCommerce de testes, utilizando o passo a passo da integração de produção.  
*(todo a processo de configuração deste modo de testes é igual às configurações de produção.)*

**URL’s de notificação em Sandbox:**

[https://e-commerce.test.easypay.pt/webhooks/easypay/generic](https://e-commerce.easypay.pt/webhooks/easypay/generic) – (Generic – URL na easypay)  
[https://e-commerce.test.easypay.pt/webhooks/easypay/transaction](https://e-commerce.easypay.pt/webhooks/easypay/transaction) – (Payment – URL na easypay)  
[https://e-commerce.test.easvpay.pt/webhooks/easvpay/authorisation](https://e-commerce.easypay.pt/webhooks/easypay/authorisation) – (Authorisation- URL na easypay)  
[https://e-commerce.test.easvpav.pt/webhooks/easvpay/visa-fwd – (Card Redirect (Visa Fwd)](https://e-commerce.easypay.pt/webhooks/easypay/visa-fwd) – URL na easypay)  
[https://e-commerce.test.easypay.pt/webhooks/easypay/visa-detail – (Card Details URL](https://e-commerce.easypay.pt/webhooks/easypay/visa-detail) (Visa Details) URL na easypay)

- [Começar](https://support.easypay.pt/knowledge-base/come%C3%A7ar?hsLang=pt-pt)
- [Conta e login](https://support.easypay.pt/knowledge-base/conta-e-login?hsLang=pt-pt)
- [Pagamentos](https://support.easypay.pt/knowledge-base/pagamentos?hsLang=pt-pt)
- [Backoffice](https://support.easypay.pt/knowledge-base/backoffice?hsLang=pt-pt)
- [Meios de pagamento](https://support.easypay.pt/knowledge-base/meios-de-pagamento?hsLang=pt-pt)
- [Soluções](https://support.easypay.pt/knowledge-base/solu%C3%A7%C3%B5es?hsLang=pt-pt)
- [Devoluções](https://support.easypay.pt/knowledge-base/devolu%C3%A7%C3%B5es?hsLang=pt-pt)
- [Parcerias](https://support.easypay.pt/knowledge-base/parcerias?hsLang=pt-pt)
- [Sandbox](https://support.easypay.pt/knowledge-base/sandbox?hsLang=pt-pt)
- [Tutoriais](https://support.easypay.pt/knowledge-base/tutoriais?hsLang=pt-pt)
- [Outros](https://support.easypay.pt/knowledge-base/outros?hsLang=pt-pt)
- [Parceiros](https://support.easypay.pt/knowledge-base/parceiros?hsLang=pt-pt)

[![logotypes](https://support.easypay.pt/hubfs/logotypes.svg "logotypes")](http://easypay.pt)

Copyright © 2026, easypay