Multibanco, MB WAY, Cartão de crédito, Apple Pay, Google Pay, Payshop, Cofidis Pay, e PIX (ifthenpay) para WooCommerce – Add-on PRO – Documentação e FAQ

A documentação e FAQs são apresentadas em português tendo em conta que a esmagadora maioria dos utilizadores deste plugin são de Portugal.

🇬🇧 The documentation and FAQs are presented in Portuguese, bearing in mind that the overwhelming majority of users of this plugin are from Portugal. If you need English support, click on the technical support link next to your license key, and open a ticket.

Multibanco, MB WAY, Credit card, Apple Pay, Google Pay, Payshop, and PIX (ifthenpay) for WooCommerce – PRO add-on, da Naked Cat Plugins, acrescenta funcionalidades avançadas ao plugin gratuito Multibanco (ifthenpay) para WooCommerce, incluindo recuperação e cancelamento automático de encomendas MB WAY, o bloco/shortcode de logótipos de pagamento, integração com a API REST, e developer hooks. Esta página cobre a configuração, o licenciamento, e as funcionalidades disponíveis. Para preços e instalação, veja a página do produto.

Suporte

Como solicitar suporte técnico?

Se a razão pela qual necessita de suporte técnico não está mencionada nesta página, clique na ligação “Suporte técnico” junto à chave de licenciamento, no ecrã de configurações do plugin (método Multibanco), e preencha o ticket.

Os utilizadores do plugin gratuito, sem licenciamento deste add-on PRO, devem usar o fórum de suporte no WordPress.org.

Onde posso submeter vulnerabilidades de segurança encontradas neste plugin?

Pode reportar erros de segurança descobertos no código deste plugin através do Patchstack Vulnerability Disclosure Program.

A equipa do Patchstack vai ajudar na verificação e na emissão de CVE, e tratar de nos notificar.

Licenciamento

Como transferir a licença de domínio?

Peça na sua área de cliente, junto à encomenda original, a mudança de domínio.

Depois de receber a resposta da Webdados de que a licença está libertada, deve ir à configuração do plugin no website antigo, remover a chave e gravar. Depois ir à configuração do plugin no site novo, inserir a mesma chave e gravar. Se o website foi transferido já com a chave na base de dados, deve remover a chave, gravar, inserir de novo e gravar de novo.

Funcionamento geral

Guia de configuração inicial

Instalação e activação

Instale e active primeiro o plugin gratuito do repositório wordpress.org. Depois, descarregue o Add-on PRO utilizando o link que está disponível no email de “order completed”, recebido imediatamente após o pagamento, e carregue-o no WordPress em Plugins > Adicionar novo. Ambos os plugins, o base/gratuito do repositório wordpress.org e este, devem estar instalados e activos. O Add-on PRO não pode ser activado sem o plugin gratuito (ver “Carreguei o Add-on PRO e apareceu um erro ao activá-lo” abaixo).

Insira a chave de licenciamento, disponível no mesmo email, em WooCommerce > Configurações > Pagamentos > Multibanco > Add-on PRO v.x > Chave de licenciamento. Depois de gravar as opções, o plugin é activado neste domínio.

Nota: Se o seu website está em Português e este ecrã de configurações ainda aparece em Inglês, deve ir a Painel > Actualizações e, no fundo da página, junto a Traduções, deverá aparecer um botão para actualizar as mesmas.

Todas as funcionalidades do Add-on PRO estão assinaladas com ⭐️.

Funcionalidades comuns a vários métodos de pagamento

As funcionalidades do Add-on PRO que sejam comuns a vários métodos de pagamento estão disponíveis no ecrã de configurações do método Multibanco, na secção Add-on PRO, devidamente assinaladas com [G].

Funcionalidades específicas de cada método de pagamento

As funcionalidades que sejam específicas de cada método de pagamento estão disponíveis no ecrã de configurações de cada método, assinaladas com ⭐️.

Memorizar o último método de pagamento utilizado

Para clientes com sessão iniciada, o checkout passa a pré-seleccionar automaticamente o método de pagamento ifthenpay utilizado na sua última encomenda, em vez da ordem de gateways definida por omissão, caso ainda não tenham escolhido nenhum método durante essa visita. Esta funcionalidade é automática, sem opção de configuração, e só actua se a última encomenda do cliente tiver sido paga com um dos nossos métodos de pagamento.

Carreguei o Add-on PRO e apareceu um erro ao activá-lo. O que se passa?

O Add-on PRO precisa do plugin gratuito Multibanco, MB WAY, Credit card, Apple Pay, Google Pay, Payshop, and PIX (ifthenpay) for WooCommerce e do WooCommerce, ambos instalados e activos. Se algum deles faltar, o WordPress recusa activar o Add-on PRO e mostra um erro a indicar que é necessário instalar e activar um plugin.

O seu website não foi danificado nem alterado. Para resolver:

  1. Vá a Plugins > Adicionar novo, pesquise por “ifthenpay”, instale e active o plugin gratuito. Também pode clicar no nome do plugin, na linha “Requer” do Add-on PRO, no ecrã Plugins.
  2. Volte a Plugins e active o Add-on PRO.

Este erro só aparece quando instala o Add-on PRO carregando o ficheiro zip. Depois do carregamento, o WordPress mostra um botão “Activar plugin” sem verificar primeiro se os plugins necessários estão presentes. No ecrã Plugins, a ligação “Activar” do Add-on PRO está desactivada até os dois plugins estarem instalados e activos.

MB WAY

Cancelar ou recuperar encomendas depois do pagamento expirar

O plugin permite definir que, depois da expiração do tempo de pagamento via MB WAY, a encomenda deve ser cancelada ou convertida em pagamento Multibanco para recuperação.

O MB WAY tem um prazo de pagamento de 4 minutos, no entanto, a notificação da SIBS à ifthenpay e, de seguida, da ifthenpay ao website pode demorar até 20 minutos. Assim, esta rotina apenas corre para encomendas cuja expiração do prazo de pagamento tenha ocorrido há mais de 20 minutos. Além disso, esta rotina está associada a uma tarefa que corre de uma em uma hora, o que significa que, para uma determinada encomenda, o cancelamento ou a conversão em Multibanco pode ocorrer num prazo de 1h00m a 1h20m após a expiração do pagamento, o que acontece 4 minutos depois de a encomenda ser inserida. Assim, se a sua intenção for converter em Multibanco e tiver cancelamento automático para encomendas “Pendentes de pagamento” activo no WooCommerce (em Configurações > Produtos > Inventário > Manter stock (minutos)), deve garantir que esse prazo seja maior que 1h24m (aconselhamos pelo menos 90 minutos), para que esse cancelamento do WooCommerce não ocorra antes da nossa rotina. Caso a sua opção seja cancelar a encomenda, não há problema se for o WooCommerce a cancelar antes da nossa rotina, mas nunca deve configurar um valor inferior a 20 minutos para garantir que recebe o callback de pagamento antes de cancelar a encomenda.

Gateway ifthenpay

Ícone por método de pagamento

A opção “Ícone por método de pagamento”, disponível no ecrã de configurações do Gateway ifthenpay, substitui o ícone genérico do Gateway ifthenpay por um ícone de cada método realmente activo (Apple Pay, Google Pay e/ou PIX).

No checkout clássico, é sempre mostrado um ícone por cada método activo, lado a lado. No checkout por blocos, apenas é possível mostrar uma única imagem, pelo que é mostrado o ícone (individual, de par ou combinado) correspondente exactamente ao conjunto de métodos activos nesse momento.

Bloco/shortcode “Logos de Pagamento ifthenpay”

Com este bloco ou shortcode, pode mostrar os ícones dos métodos de pagamento ifthenpay disponíveis na sua loja online, no rodapé ou em qualquer outra área do seu website.

Se utilizar o bloco, todas as opções de personalização estão disponíveis na barra lateral.

Se utilizar o shortcode, estes são os parâmetros disponíveis:

  • logos: auto (mostra os métodos activos), all (mostra todos os métodos), ou uma lista separada por vírgulas de métodos de pagamento (multibanco, mbway, creditcard, payshop, gateway_ifthen)
  • gatewaylogos: yes (mostra os ícones individuais de Apple Pay, Google Pay e PIX em vez do logotipo da gateway ifthenpay)
  • creditcardlogos: yes (mostra os ícones individuais da Visa e da Mastercard em vez do ícone genérico de cartão de crédito)
  • includebacs: yes (se quiser mostrar um ícone de transferência bancária)
  • includepaypal: yes (se quiser mostrar o logotipo do PayPal, caso tenha o PayPal activo na sua loja)
  • includestripe: yes (se quiser mostrar os logotipos de cartão de crédito, caso tenha o Stripe activo na sua loja, respeitando a opção creditcardlogos para ícone genérico ou Visa + Mastercard)
  • includessl: yes (se quiser mostrar um ícone de certificado SSL)
  • showlabels: yes (se quiser mostrar o nome de cada método de pagamento por baixo do respectivo ícone)
  • labelfontsize: valor CSS de tamanho de letra dessas legendas (por omissão herdam o tamanho de letra definido pelo tema)
  • maxheight: valor CSS de altura máxima de cada ícone (40px por omissão)
  • maxwidth: valor CSS de largura máxima de cada ícone (auto por omissão)
  • gap: valor CSS de espaçamento entre ícones
  • alignitems: valor CSS de alinhamento vertical flex
  • justifycontent: valor CSS de alinhamento horizontal flex
  • color: auto (mantém as cores originais de cada logotipo, por omissão) ou um código de cor CSS, por exemplo #333333, para mostrar todos os logotipos numa só cor
  • id: para atribuir um identificador único ao container dos logos (número aleatório por omissão)

API REST

Quais os requisitos ao criar uma encomenda Multibanco via API REST para que a referência seja automaticamente emitida?

Em primeiro lugar, tem de ter a opção “Accionar pagamentos para encomendas API REST” activa.

A chamada REST tem de incluir estes parâmetros, com os valores indicados:

{
    "currency": "EUR",
    "payment_method": "multibanco_ifthen_for_woocommerce",
    "payment_method_title": "Multibanco",
    "status": "on-hold",
    "billing": {
        ...
    },
    "shipping": {
        ...
    },
    "line_items": [
        ...
    ],
    "meta_data": [
        ...
    ]
}

Quais os requisitos ao criar uma encomenda MB WAY via API REST para que o pedido de pagamento seja automaticamente efectuado?

Em primeiro lugar, tem de ter a opção “Accionar pagamentos para encomendas API REST” activa.

A chamada REST tem de incluir estes parâmetros, com os valores indicados:

{
    "currency": "EUR",
    "payment_method": "mbway_ifthen_for_woocommerce",
    "payment_method_title": "MB WAY",
    "status": "pending",
    "billing": {
        ...
    },
    "shipping": {
        ...
    },
    "line_items": [
        ...
    ],
    "meta_data": [{
        "key": "_mbway_ifthen_for_woocommerce_phone",
        "value": "9xxxxxxxx"
    }]
}

Developer hooks disponíveis

Filter: wc_ifthepay_entity_category_limit_cart_error_message

Permite manipular a mensagem que aparece no carrinho quando já existem produtos de outra conta de pagamento, se o modo “Entidades por categoria” estiver activo.

Parâmetros: $message, $product_id, $variation_id