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.
Lista de conteúdos
Suporte
Como solicitar suporte técnico?
Se a razão pela qual necessita suporte técnico não está mencionada nesta página, clique no link de suporte junto à chave de licenciamento, no ecrã de definições do plugin (método Multibanco), e preencha o ticket.
Os utilizadores do plugin gratuito, sem licenciamento desde 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, emissão de CVE e tratar de nos notificar.
Licenciamento
Como transferir a licença de domínio?
Pedir na sua área de cliente, junto à encomenda original, a mudança de domínio
Depois de receber a resposta da Webdados 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
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 ficar instalados e activos.
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 ficará 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 os 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 ⭐️.
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.
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), lista separada por vírgulas de métodos de envio (multibanco, mbway, creditcard, payshop, cofidispay, gateway_ifthen)
- gatewaylogos: yes (mostra os ícones individuais de Apple Pay, Google Pay e PIX em vez do logotipo da gateway ifthenpay)
- includebacs: yes (se quiser mostrar um ícone de transferência bancária)
- includessl: yes (se quiser mostrar um ícone de certificado SSL)
- 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
- justifiycontent: valor CSS de alinhamento horizontal flex
- 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 te de ter a opção “Accionar pagamentos para encomendas API REST” activa.
A chamada REST tem de incluir os parâmetros marcados a bold, com os valores indicados:
{
<strong>"currency": "EUR",
"payment_method": "multibanco_ifthen_for_woocommerce",
"payment_method_title": "Multibanco",
"status": "on-hold",</strong>
"billing": {
...
},
"shipping": {
...
},
"line_items": [
...
],
"meta_data": [
...
]
}Code language: PHP (php)Quais os requisitos ao criar uma encomenda MB WAY via API REST para que o pedido de pagamento seja automaticamente efectuado?
Em primeiro lugar te de ter a opção “Accionar pagamentos para encomendas API REST” activa.
A chamada REST tem de incluir os parâmetros marcados a bold, com os valores indicados:
{
<strong>"currency": "EUR",
"payment_method": "mbway_ifthen_for_woocommerce",
"payment_method_title": "MB WAY",
"status": "pending",</strong>
"billing": {
...
},
"shipping": {
...
},
"line_items": [
...
],
"meta_data": [{
<strong>"key": "_mbway_ifthen_for_woocommerce_phone",
"value": "9xxxxxxxx"</strong>
}]
}Code language: PHP (php)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
Filter: wc_ifthepay_cofidispay_max_instalments
Permite alterar o número de meses máximo para o cálculo das prestações Cofidis no banner na página de produto
Parâmetros: $instalments
Exemplo de utilização:
add_filter( 'wc_ifthepay_cofidispay_max_instalments', function( $instalments ) {
return 10; // Instead of the default 12
} );Code language: PHP (php)Filter: wc_ifthepay_cofidispay_product_banner_action
Permite alterar o hook onde o plugin coloca o banner Cofidis na página de produto
Parâmetros: $hook
Exemplo de utilização:
add_filter( 'wc_ifthepay_cofidispay_product_banner_action', function( $hook ) {
return 'woocommerce_before_single_product_summary'; // Instead of the default woocommerce_single_product_summary
} );Code language: PHP (php)Shortcodes disponíveis
ifthenpay_cofidispay_product_banner
Permite mostrar o banner Cofidis Pay caso a página de produto esteja customizada ao ponto do hook woocommerce_single_product_summary (que usamos para mostrar o banner) não seja invocado.
Parâmetros: product_id
Opcional. Por omissão mostra o produto que está a ser visualizado no momento, mas pode ser usado para mostrar o banner de um produto específico numa outra página, por exemplo uma landing page de promoção desse produto.