O seu negócio cresce com a easypay
Simplificamos a complexidade com soluções de pagamento que agilizam a gestão dos negócios, economizam tempo na verificação de pagamentos e preparam a sua empresa para vender mais para todo o mundo.
Configurar easypay WooCommerce - API 2.0
Última atualização: 2 julho 2022
Plugin Easypay para woocommerce
Os plugins servem como software entre sua loja e o serviço de pagamento online (APIs) da easypay, podendo:
- Ter um ou mais plugins instalados, dependendo do seu contrato com a easypay.
- Testar os serviços de pagamento online da easypay (sandbox) com esses plugins antes de entrar em produção.
Plugins de meios de pagamento disponíveis
Os plugins servem como software entre sua loja e o serviço de pagamento online (APIs) da easypay, podendo:
1. Cartões Visa & Mastercard (apenas pagamentos pontuais)
2. Referências MB
3. MB Way
4. Santander Consumer Finance (apenas pagamentos pontuais)
5. Universo Flex (apenas pagamentos pontuais)
Como funciona
Os seus clientes fazem uma compra e pagam através do Cartão Visa & Mastercard / Ref Multibanco / MBWa/ Santander Consumer Finance/ Universo Flex através do plugin de pagamento easypay.
Assim que o processo de pagamento for concluído, a easypay notifica o plugin o que poderá verificar também no Backoffice da easypay ou no seu próprio sistema.
1. Cartões Visa & Mastercard easypay no WooCommerce
Permite o pagamento de encomendas por cartão Visa & Mastercard (pagamento pontual) na sua loja. O cliente salta para a gateway easypay onde terá uma autorização segura do valor no cartão e posterior captura (manual ou automática).
Quando o seu cliente finalizar a compra, será encaminhado para a gateway de cartões Visa & Mastercard da easypay para inserir os detalhes do cartão. Após a transação ser autorizada pelo emissor do cartão (banco, revolut, unibanco, sibs) o cliente é redirecionado de volta para a sua loja online.
Se configurou a captura automática, o plugin tenta capturar os fundos o mais rápido possível. Assim que o processo de pagamento for concluído, a easypay notifica o plugin.
2. Referências Multibanco Easypay no WooCommerce
Este plugin permite o pagamento de encomendas por Referências Multibanco na sua loja utilizando a easypay como gateway de pagamento. Ao finalizar a compra, o seu cliente recebe um e-mail com o identificador de pagamento necessário (Entidade, Referência, Valor) para efetuar o pagamento no homebanking do banco ou numa máquina Multibanco. Assim que o processo de pagamento for concluído, a easypay notifica o plugin.
3. MBWay Easypay no WooCommerce
Este plugin permite o pagamento de encomendas por MBWay na sua loja utilizando a easypay como gateway de pagamentos e a aplicação MBWay instalada no telemóvel do cliente.
Quando o seu cliente finalizar a compra, recebe uma notificação na aplicação MBWay do seu pedido de pagamento com o valor da encomenda. O plugin aguarda 5 minutos pelo cliente OK ou NÃO OK. Quando o cliente autoriza a transação, o plugin tenta obter os fundos do cliente se a captura automática estiver configurada. Se não estiver automática pode configurá-lo no Backoffice da easypay.
Se os 5 minutos se esgotarem e o cliente não fizer nada, o pedido e a autorização serão automaticamente cancelados. Este método de pagamento só funciona se o telemóvel tiver aderido previamente ao sistema MBWay.
4. Santander Consumer Finance easypay no WooCommerce
Note que para ter o Santander Consumer Finance disponível no seu site tem que informar a easypay da sua intenção que irá confirmar junto do Santander Consumer Finance que a sua área de negócio é elegível. A aprovação é rápida. Este plugin permite o pagamento de encomendas por (pagamento pontual) na sua loja através do recurso a financiamento. O cliente ao selecionar este meio de pagamento vai para a gateway do Santander Consumer Finance seguindo os passos indicados. Nomeadamente, inserir os detalhes do pedido de financiamento. Após o financiamento ser aprovado ou recusado pelo acquirer (Santander Consumer Finance) a easypay irá notificar o plugin com sucesso ou recusado de acordo com a decisão do acquirer.
Nota:
● Os serviços do Santander Consumer Finance só permitem pagamentos de valores entre 200€ e 6000€. Portanto, na sua loja, o plug-in ocultará esse método de pagamento automaticamente para encomendas com valores que estejam fora desse intervalo.
● Para disponibilizar este meio de pagamento tem que contatar primeiro a easypay para garantir que se encontra elegível nas áreas de negócio aceites pelo Santander Consumer Finance.
5. Universo Flex easypay no WooCommerce
Permite o pagamento de encomendas por (pagamento pontual) na sua loja. O cliente final, ao selecionar este meio de pagamento vai para a gateway do Universo Flex, onde terá de seguir os passos indicados. Nomeadamente, selecionar a modalidade de pagamento que prefere e confirmar o mesmo. Após este processo, a autorização será aprovada ou recusada pelo acquirer (Universo Flex) e o cliente é redirecionado de volta para a loja online.
A easypay irá notificar o plugin com sucesso ou recusado de acordo com a decisão do acquirer. Se configurou a captura automática, o plugin tenta capturar os fundos o mais rápido possível. Assim que o processo de pagamento for concluído, a easypay notifica a captura ao plugin.
Antes de instalar o Plugin easypay
● Atenção que caso já tenha uma versão do plugin easypay woocommerce tem sempre que começar por desinstalar as versões anteriores do plugin. É altamente recomendável não ter versões mais antigas do plugin instaladas simultaneamente.
● Tem que ter uma Conta de Pagamentos easypay – sandbox ou produção – com os meios de pagamento desejados ativados. Na Adesão à easypay indique os meios de pagamento que deseja.
● Depois de ter sua conta ativa, no backoffice easypay deve ir para:
WebServices> Plugins> Woocommerce:
- Selecione a Conta de Pagamentos easypay que pretende ligar à sua loja woocommerce.
- Em Chaves> + Nova (botão), dê um nome à sua chave API e guarde-a (woocommerce-nome do site). Será redirecionado de volta e a tabela mostrará o ID da conta e a chave Irá precisar desta informação no seu plugin.
Instalar o Plugin easypay
(1) Faça o download do plugin em https://www.easypay.pt/woocomerce/ de acordo com os meios de pagamento que pretende utilizar: Multibanco, Cartões Visa & Mastercard e MBWay e Santander Consumer Finance, Universo Flex.
(2) Instale com a ferramenta WordPress de instalação de plugins OU abra o zip do plugin e copie como uma pasta para o diretório de plugins, certificando-se de que o servidor consegue ler o diretório de ficheiros do plugin (555) e ficheiros (444).
(3) Ative o plugin na lista de plugins. É dado um nome ao plugin de acordo com o meio de pagamento:
- Easypay CC
- Easypay MB
- Easypay MBWay
- Easypay Santander Consumer Finance
- Easypay Universo Flex
Nota: tem que ter o woocommerce já instalado.
Configuração do Plugin easypay
Todos os plugins requerem um ID de conta (Conta de Pagamentos easypay) e uma chave API.
Deve criar estas chaves no backoffice da easypay antes de instalar o Plugin easypay.
Coloque o ID de conta e chave API no plug-in
Easypay sandbox
- Marque esta caixa se quiser usar a sandbox easypay (modo de teste).
- Se estiver a utilizar a Sandbox, o ID da conta e a chave API devem ser gerados no backoffice sandbox da easypay: WebServices> Sandbox easypay
- O ID da conta de produção e o par de chaves API não funcionarão no modo de testes e vice-versa.
Nota: Quando o modo de testes está ativado não há transação de qualquer valor monetário. Use-o apenas para fins de teste.
Debug
Selecione esta opção se quiser verificar os logs dos erros, ativando a opção “Enable logging“.
Configurações específicas do plugin
Cartões Visa & Mastercard easypay para woocommerce
Note que para ter os Cartões Visa & Mastercard disponíveis no seu site a easypay tem que colocar o site em aprovação pela Visa & Mastercard- o que faz diretamente com a easypay. Comunique à easypay a sua intenção de activar este meio de pagamento, para poder ser feita a validação e activação. A aprovação pode demorar uns dias.
Captura Automática – Auto Capture
Selecione esta opção se desejar que os fundos sejam capturados automaticamente após a autorização do pagamento.
URL de notificação
Este é o URL do seu sistema – Notification URL – que a easypay usará para comunicar com o plugin, para comunicar o status do pagamento ou outras operações. Se usar mais do que um método de pagamento, no backoffice da easypay apenas vai configurar um Generic URL (é indiferente qual).
Faça copy paste do notification URL para o backoffice easypay:
> Web Services > Plugin > Woocommerce > “Notificações” > colar em Generic-URL
VISA-FWD URL
Este é o URL para o qual seu cliente é redirecionado após sair da gateway de pagamentos da easypay, com pagamento autorizado ou recusado.
Faça copy paste deste URL para o backoffice easypay > Web Services > Plugin > Woocommerce > “Notificações” > colar em Card Redirect (Visa Fwd) – URL
Basta registar apenas uma vez um Generic-URL (é indiferente qual).
Multibanco easypay no WooCommerce
Expiration in days
Defina por quantos dias pretende que o pagamento possa ser efetuado. Depois dessa data o seu cliente já não poderá fazer o pagamento. Um valor entre 1 e 3 dias é satisfatório para a grande maioria dos comerciantes mas são aceites valores de 1 a 93 dias dias.
As referências de pagamento são válidas até às 23:59 do dia definido.
Permitir Expiração para as Referências MB
Selecione esta opção para forçar a expiração do pagamento. O seu cliente não poderá pagar após o número de dias definido. Se não selecionar esta opção, a referência de pagamento não tem data de validade. Se ativar esta opção, uma vez paga esta referência, ela já não poderá voltar a ser paga.
URL de notificação
Este é o URL do seu sistema que a easypay usará para comunicar com o plugin, para comunicar o status do pagamento ou outras operações. Se você tiver mais de uma forma de pagamento, só precisa de fazer esta configuração uma vez.
Deve utilizar Ref. MB por padrão. Se você não estiver a utilizar as ref. MB, utilize MBWay.
Faça copy paste deste URL para o backoffice easypay > Web Services > Plugin > Woocommerce > “Notificações” > colar em Generic-URL
Basta registar apenas uma vez um Generic-URL e é indiferente qual.
MBWay Easypay no WooCommerce
Captura automática
Selecione esta opção se desejar que os fundos sejam capturados automaticamente após a autorização do pagamento.
URL de notificação
Este é o URL do seu sistema que a easypay usará para comunicar com o plugin, para comunicar o status do pagamento ou outras operações.
Faça copy paste deste URL para o backoffice easypay > Web Services > Plugin > Woocommerce > “Notificações” > colar em Generic-URL
Basta registar apenas uma vez um Generic-URL e é indiferente qual.
Santander Consumer Finance easypay para woocommerce
Note que para ter o Santander Consumer Finance disponível no seu site a easypay tem que colocar o site para aprovação pelo Santander Consumer Finance diretamente com a easypay.
URL de notificação
Este é o URL do seu sistema – Notification URL – que a easypay usará para comunicar com o plugin, para comunicar o status do pagamento ou outras operações. Se usar mais do que um método de pagamento, no backoffice da easypay apenas vai configurar um Generic URL (é indiferente qual).
Faça copy paste do notification URL para o backoffice easypay:
> Web Services > Plugin > Woocommerce > “Notificações” > colar em Generic-URL
Universo Flex easypay para woocommerce
Note que para ter o Universo Flex disponível no seu site, a easypay tem que ter o meio de pagamento activo na easypay – comunique à easypay a sua intenção de activar o Universo Flex.
Captura Automática – Auto Capture
Selecione esta opção se desejar que os fundos sejam capturados automaticamente após a autorização do pagamento.
URL de notificação
Este é o URL do seu sistema – Notification URL – que a easypay usará para comunicar com o plugin, para comunicar o status do pagamento ou outras operações. Se usar mais do que um método de pagamento, no backoffice da easypay apenas vai configurar um Generic URL (é indiferente qual).
Faça copy paste do notification URL para o backoffice easypay:
> Web Services > Plugin > Woocommerce > “Notificações” > colar em Generic-URL
VISA-FWD URL
Este é o URL para o qual seu cliente é redirecionado após sair da gateway de pagamentos da easypay, com pagamento autorizado ou recusado.
Faça copy paste deste URL para o backoffice easypay > Web Services > Plugin > Woocommerce > “Notificações” > colar em Card Redirect (Visa Fwd) – URL
Basta registar apenas uma vez um Generic-URL (é indiferente qual).
Notas Finais
- Se desejar saber como o plugin usa as APIs de pagamento easypay, pode ler os nossos documentos online disponíveis em https://api.prod.easypay.pt/docs
- Sempre que um pagamento é realizado com sucesso, a easypay envia uma “Notificação Genérica” para o vosso “Generic – URL” com o “id” do “single payment” pago, mencionando “type”:”capture”, “status”:”success” e a data / hora do pagamento.
- Ao receber esta notificação, o vosso sistema pode colocar na vossa tabela de pagamentos os detalhes do pagamento contidos neste “id”. Por isso, é imperativo que o “Generic – URL” esteja preenchido no vosso Back Office.
- É indiferente que o campo “Generic – URL” esteja preenchido com o “Notification:URL” do MB, do Cartão de Crédito, do MBWay, do SC (Santander Consumer Finance) ou do UF (Universo Flex) pois o vosso sistema é notificado de um pagamento ou duma autorização de captura – independentemente do meio de pagamento (“method”) escolhido pelo vosso cliente.
- Mais detalhes sobre a nossa “Notificação Genérica” encontram-se disponíveis em https://api.prod.easypay.pt/docs#tag/Notification%2Fpaths%2F~1your-generic-notification-endpoint%2Fpost .