MB Way e Multibanco no WooCommerce: guia para lojas em Portugal

MB Way e Multibanco são métodos de pagamento essenciais para qualquer loja WooCommerce em Portugal. A ausência destas opções pode custar 30-50% das conversões em mercado nacional. Este guia cobre as opções de integração disponíveis, o que cada uma oferece e como configurar corretamente para produção.

O panorama de pagamentos em Portugal

O mercado português tem características únicas que distinguem a configuração de lojas locais das lojas europeias genéricas:

• MB Way: pagamento imediato por smartphone. Muito popular para compras online — o cliente recebe notificação e aprova em segundos.
• Referência Multibanco: o cliente recebe uma referência (entidade, referência, valor) e paga em caixa MB ou home banking até expirar. Popular entre quem não tem cartão de crédito ou prefere pagar presencialmente.
• Cartão de crédito/débito: via Stripe, Braintree ou gateway bancário.
• Transferência bancária (SEPA): para B2B ou valores elevados.

Não oferecer MB Way e Multibanco numa loja nacional é deixar dinheiro na mesa. Não é opcional.

Opções de integração: Easypay vs IfThenPay vs outros

Easypay

Um dos gateways portugueses mais estabelecidos. Oferece MB Way, Multibanco, cartão, débito direto e Payshop. O plugin oficial para WooCommerce está disponível no repositório WordPress e é mantido ativamente.

Prós: suporte técnico em português, documentação detalhada, painel de gestão claro.
Contras: comissões ligeiramente superiores aos gateways internacionais para cartão. Verifique a tabela de preços atual antes de contratar.

IfThenPay

Gateway focado especificamente no mercado português com Multibanco e MB Way. Plugin WooCommerce gratuito e bem mantido. Muito usado por PMEs pela simplicidade e preço competitivo.

Prós: configuração simples, boa documentação, suporte responsivo.
Contras: menos opções de pagamento internacional que a Easypay.

Stripe + plugin de Multibanco

A Stripe suporta MB Way nativamente através do Payment Element desde 2023. Para Multibanco (referências ATM), existe suporte nativo também. Esta é a opção mais elegante para lojas que já usam Stripe para cartão — um único gateway, uma única integração.

Eupago e PaymentSense

Alternativas com plugins WooCommerce disponíveis. Menos populares mas viáveis. Verifique compatibilidade com a versão de WooCommerce em uso antes de recomendar ao cliente.

Configuração passo a passo: Easypay como exemplo

1. Criar conta e ambiente de sandbox

Crie uma conta em Easypay e ative o ambiente de sandbox (testes). A maioria dos gateways portugueses oferece ambiente de testes separado do de produção. Nunca configure credenciais de produção diretamente sem testar em staging.

2. Instalar e ativar o plugin

Instale o plugin Easypay Gateway for WooCommerce. Aceda a WooCommerce → Settings → Payments. Ative os métodos desejados (MB Way, Multibanco) individualmente.

3. Configurar notificações (webhooks)

Este é o passo mais crítico e onde mais erros acontecem. O gateway precisa de notificar o WooCommerce quando um pagamento é confirmado. Configure o URL de notificação no painel do gateway:

https://seusite.pt/wc-api/easypay

Verifique que o URL é acessível publicamente (não funciona em localhost) e que não há regras de firewall ou Cloudflare a bloquear as notificações do IP do gateway.

4. Configurar expiração de referências Multibanco

Defina a validade das referências — tipicamente 48h a 72h para B2C, até 15 dias para B2B. O WooCommerce deve cancelar automaticamente encomendas com referências expiradas. Verifique que o cron do WordPress está funcional para este processo automático.

5. Testar o fluxo completo em staging

Antes de ir para produção, teste:

• Pagamento MB Way completo (aprovação e cancelamento)
• Pagamento Multibanco (geração de referência e confirmação simulada)
• Email de confirmação ao cliente após pagamento
• Estado da encomenda no WooCommerce após cada ação
• Comportamento de stock (reserva durante pendente, libertação após cancelamento)

Problemas comuns e resolução

Referências Multibanco geradas mas pagamento não confirmado

Causa mais comum: webhook a falhar. Verifique nos logs do gateway se a notificação foi enviada. Verifique em WooCommerce → Status → Logs se há erros relacionados com o gateway. Confirme que o URL de webhook está correto e sem HTTPS a dar erro.

MB Way notificação não chega ao cliente

Pode ser problema de SMTP ou de número de telefone em formato errado. O número deve ser enviado sem espaços e no formato português (9XXXXXXXX). Verifique o log de erros do plugin e os logs de email SMTP.

Encomendas a ficar em "Pendente" indefinidamente

O cron do WordPress pode não estar a correr. Verifique com WP-CLI: wp cron test. Se o cron estiver desativado ou a falhar, as encomendas expiradas não serão canceladas automaticamente.

Manutenção contínua de gateways de pagamento

Os gateways de pagamento são componentes críticos que merecem atenção especial na manutenção mensal do WooCommerce:

• Verifique versão do plugin de gateway — atualizações de segurança são comuns
• Teste pagamento de baixo valor mensalmente para confirmar que está tudo funcional
• Verifique validade de credenciais e certificados da API do gateway
• Confirme que os webhooks continuam ativos no painel do gateway