Resposta rápida
Como integrar MB Way e Multibanco no WooCommerce?
A forma mais rápida e recomendada é através do IFTHENPAY, o principal gateway de pagamentos portugueses, com plugin gratuito para WooCommerce. O processo tem 4 passos, criar conta gratuita no IFTHENPAY, aguardar aprovação (1 a 2 dias úteis), instalar o plugin gratuito “Ifthenpay Gateway” no WordPress, e configurar as chaves de API fornecidas pelo IFTHENPAY nas definições do plugin. Depois disso, MB Way e Multibanco aparecem automaticamente no checkout da loja como opções de pagamento. Não há custo de setup, sem mensalidade, paga-se apenas uma comissão por transação (tipicamente 0,5% a 1,5% dependendo do volume). A alternativa é o Eupago, com funcionamento semelhante e plugin próprio para WooCommerce.
O que vai aprender neste artigo?
Qual o melhor para lojas portuguesas.
Da conta ao checkout ativo.
Antes de publicar.
Os erros mais frequentes.
Uma loja WooCommerce sem MB Way em Portugal está a perder cerca de metade das suas vendas potenciais por fricção no momento do pagamento. É a realidade do mercado português, 74% dos consumidores preferem MB Way ou Multibanco em compras online.
A boa notícia é que a integração é mais simples do que parece, e gratuita. Este guia mostra exatamente o que fazer, passo a passo.
MB Way ou Multibanco, diferenças práticas para a loja
Apesar de ambos serem geridos pela SIBS e integrados via IFTHENPAY ou Eupago, MB Way e Multibanco têm comportamentos muito diferentes do ponto de vista da loja e do cliente. Perceber a diferença ajuda a configurar corretamente cada um.
MB Way
- Pagamento instantâneo via app MB Way no telemóvel
- Cliente insere número de telemóvel no checkout
- Recebe notificação push para aprovar em segundos
- Encomenda confirmada automaticamente no WooCommerce
Multibanco
- Gera referência Multibanco (Entidade, Referência e Valor)
- Cliente paga em ATM ou homebanking num prazo definido
- Confirmação pode demorar minutos a horas após pagamento
- Prazo de pagamento configurável (24h a 72h típico)
Opinião TTHRIVE
Estes métodos de pagamento não são concorrentes, servem perfis de cliente diferentes. O cliente mais jovem e mobile prefere MB Way pela rapidez. O cliente mais velho ou com compra de valor mais alto prefere Multibanco por confiar mais no processo. Ter apenas um dos dois não captura todo o mercado. E o custo de configurar os dois é exatamente o mesmo, zero.
IFTHENPAY, Eupago ou Stripe
Há três opções principais para integrar pagamentos portugueses no WooCommerce. A escolha certa depende do volume de vendas, dos métodos de pagamento que quer oferecer, e da complexidade que está disposto a gerir.
| Critério | IFTHENPAY ⭐ Recomendado | Eupago | Stripe |
|---|---|---|---|
| MB Way nativo | ✓ Nativo, SIBS directo | ✓ Nativo | ✗ Não disponível |
| Multibanco nativo | ✓ Nativo, SIBS directo | ✓ Nativo | ✗ Não disponível |
| Cartão crédito ou débito | ✓ Via CoffeeDesk | ✓ Disponível | ✓ Especialidade do Stripe |
| Custo de setup | 0€ | 0€ | 0€ |
| Mensalidade | 0€ | 0€ | 0€ |
| Comissão MB Way | 0,5% a 1,5% por transação | 0,8% a 2% por transação | Não há |
| Plugin WooCommerce | ✓ Gratuito · WordPress.org | ✓ Gratuito | ✓ Gratuito · oficial |
| Tempo de ativação | 1 a 2 dias úteis | 2 a 5 dias úteis | Imediato (cartão) |
| Suporte em português | ✓ Sim · empresa portuguesa | ✓ Sim · empresa portuguesa | Inglês (suporte português limitado) |
| Para lojas portuguesas | ✓ Ideal | ✓ Muito bom | Bom para cartão · Sem MB Way |
A conclusão é clara, para uma loja WooCommerce que vende principalmente em Portugal, IFTHENPAY é a escolha principal por ser a ligação mais direta à SIBS (a entidade que gere MB Way e Multibanco em Portugal), por ter comissões competitivas e por ser gratuito para começar. O Stripe pode ser mantido em paralelo para clientes que preferem cartão, os dois gateways coexistem sem problema no WooCommerce.
O que está incluído e como funciona o IFTHENPAY
RECOMENDADO TTHRIVE
IFTHENPAY (MB Way, Multibanco e Cartão numa só integração)
O IFTHENPAY é o principal gateway de pagamentos nacionais em Portugal, com integração direta à SIBS. Uma única conta dá acesso a MB Way, Multibanco, MBNet e cartão via CoffeeDesk. O plugin oficial para WooCommerce é gratuito, ativamente mantido, e funciona com o WooCommerce standard sem configurações complexas.
Custo de setup
0€
Tempo de ativação
1 a 2 dias
Métodos disponíveis
MB Way, Multibanco e Cartão
Plugin WooCommerce
Gratuito
Passo a passo para integrar IFTHENPAY no WooCommerce
Este guia assume que já tem uma loja WooCommerce funcional no WordPress. Se ainda não tem, veja o nosso guia de criação de loja online primeiro.
1. Criar conta no IFTHENPAY
Aceder a ifthenpay.com e clicar em “Criar conta” ou “Aderir agora”. Preencher o formulário com os dados do negócio (nome, NIF, IBAN português (para onde vão ser transferidos os pagamentos), e tipo de negócio). O IFTHENPAY é exclusivo para entidades com NIF português, empresas, ENI e profissionais liberais.
2. Aguardar aprovação e receber chaves de API
Após submeter o formulário, o IFTHENPAY verifica os dados em 1 a 2 dias úteis. Quando aprovado, recebe por email as chaves de API para cada método de pagamento, uma Backoffice Key (chave principal da conta) e as chaves específicas de cada gateway (MB Way Key, Entidade e Sub-Entidade para Multibanco). Guarde estes dados, são necessários para configurar o plugin.
3. Instalar o plugin "Ifthenpay Gateway" no WordPress
No painel de administração do WordPress, ir a Plugins → Adicionar Novo. Pesquisar por ifthenpay ou Ifthenpay Gateway. O plugin oficial tem o autor “Ifthenpay” e está disponível no repositório oficial do WordPress.org. Clicar em Instalar Agora e depois Activar.
4. Configurar MB Way no plugin
Após ativar o plugin, ir a WooCommerce → Definições → Pagamentos. Aparece a lista de métodos de pagamento disponíveis, agora com “MB Way” e “Multibanco” na lista. Clicar em Gerir junto ao MB Way. Ativar o método e preencher o campo MB Way Key com a chave recebida por email do IFTHENPAY. Guardar as definições.
5. Configurar Multibanco no plugin
Na mesma página de pagamentos, clicar em Gerir junto ao Multibanco. Ativar o método e preencher os campos Entidade e Sub-entidade (fornecidos pelo IFTHENPAY no email de aprovação) e definir o prazo de validade da referência, recomendamos 48h a 72h para dar tempo ao cliente de pagar. Configurar também o callback URL se disponível, é o endereço que o IFTHENPAY usa para notificar a loja quando o pagamento é confirmado.
6. Configurar o Callback para confirmação automática
O callback é o mecanismo que permite ao IFTHENPAY notificar a loja quando um pagamento Multibanco ou MB Way é confirmado, atualizando o estado da encomenda automaticamente de “Aguarda pagamento” para “Processando”. Sem callback, as encomendas ficam em espera indefinidamente mesmo após o cliente pagar. No painel do IFTHENPAY, ir a cada gateway e ativar o callback com o URL fornecido pelo plugin.
7. Testar com um pagamento real de valor baixo
Antes de considerar a integração completa, fazer um teste com uma encomenda real de valor baixo (1€ a 5€), pagar com MB Way e verificar se a encomenda no WooCommerce atualiza para “Processando” automaticamente após confirmação. Repetir o teste com Multibanco se também configurado. Verificar também se o email de confirmação de encomenda é enviado correctamente após o pagamento ser confirmado.
Como testar se os pagamentos estão a funcionar correctamente
Antes de considerar a integração completa e comunicá-la aos clientes, é essencial verificar que todo o fluxo funciona end-to-end. Há cinco pontos a verificar.
Checklist de verificação após configuração do IFTHENPAY
Verificar todos os pontos antes de publicar. MB Way e Multibanco aparecem como opções no checkout da loja, ao seleccionar MB Way, o campo de telemóvel aparece corretamente, ao finalizar encomenda com MB Way, a notificação chega ao telemóvel associado, após aprovar o pagamento, o estado da encomenda no WooCommerce atualiza automaticamente para “Processando”, o email de confirmação de encomenda é enviado ao cliente após confirmação de pagamento, ao seleccionar Multibanco, a referência (Entidade, Referência e Valor) aparece corretamente na página de agradecimento e no email e ao pagar a referência Multibanco, o estado atualiza automaticamente (confirma que o callback está configurado). Se algum destes pontos falhar, verificar primeiro a configuração do callback no backoffice do IFTHENPAY.
Problemas comuns e como resolver
MB Way não aparece no checkout
A causa mais comum é o plugin não estar ativado ou a MB Way Key não foi guardada correcamente. Verificar em WooCommerce → Definições → Pagamentos se o toggle do MB Way está ativo. Confirmar que a MB Way Key está preenchida sem espaços antes ou depois do código. Se o método foi ativado mas não aparece no checkout, verificar se há conflito com o tema, alguns temas de checkout personalizado (como o Flatsome ou temas com checkout em 1 passo) requerem configuração adicional.
Encomenda fica em "Aguarda pagamento" mesmo após cliente pagar
A causa pode ser o callback não estar configurado ou URL de callback incorreto. O callback é o mecanismo que notifica a loja quando o IFTHENPAY confirma o pagamento. Verificar no backoffice do IFTHENPAY se o callback está ativo e se o URL corresponde ao formato https://sualoja.pt/?wc-api=ifthenpay_mbway. O URL tem de ser acessível publicamente, não funciona em localhost ou em sites em modo de manutenção.
Notificação MB Way não chega ao cliente
Causas possíveis são o número de telemóvel inserido sem o indicativo correto (deve ser inserido como 9XXXXXXXX, sem +351), número não associado ao MB Way, ou app MB Way desatualizada no telemóvel do cliente. O campo de telemóvel no checkout pode ser configurado com validação de formato para reduzir erros. O IFTHENPAY tem um timeout de 4 minutos para aprovação, se o cliente não aprovar nesse prazo, a encomenda fica pendente e pode ser necessário recriar o pedido.
Erro "Conta IFTHENPAY não aprovada"
O IFTHENPAY requer verificação da conta antes de permitir transações reais. Se a conta ainda está em análise, os pagamentos ficam bloqueados. Verificar o email de registo para mensagens do IFTHENPAY, pode haver documentação adicional em falta. O processo de aprovação padrão leva 1 a 2 dias úteis, se ultrapassar 3 dias, contactar o suporte do IFTHENPAY diretamente.
