Xpend
Começar grátis
ComeçarPagamentosIntegraçõesReferência APIChangelog

Plugin WooCommerce

O plugin oficial Xpend para WooCommerce adiciona MB WAY e Multibanco como métodos de pagamento na tua loja. O cliente paga directamente no checkout, sem redireccionamentos.

Requisitos

  • WordPress 6.0 ou superior
  • WooCommerce 7.0 ou superior
  • PHP 7.4 ou superior
  • Conta Xpend activa, com chaves de API

Instalação

  1. No backoffice Xpend, vai a Integrações → WooCommerce e descarrega o plugin (.zip).
  2. No WordPress: Plugins → Adicionar novo → Carregar plugin, escolhe o .zip e instala.
  3. Clica em Activar.
  4. Vai a WooCommerce → Definições → Pagamentos e activa Xpend — MB WAY e Xpend — Multibanco.
  5. Abre o separador Xpend — MB WAY e cola a Chave Pública, a Chave Secreta e o Segredo do Webhook (obténs em Dashboard → Definições → Chaves API ou em Integrações). As chaves são partilhadas automaticamente com o gateway Multibanco.
  6. O plugin mostra um URL de webhook (algo como https://a-tua-loja.com/wp-json/xpend/v1/webhook). Copia-o e configura-o nas definições de webhook do backoffice Xpend.
  7. Faz uma encomenda de teste para confirmar.

Como funciona

MB WAY: o cliente introduz o telemóvel no checkout, a loja dispara a notificação e o cliente confirma na app — sem sair da loja. A encomenda fica em espera e passa a processando/concluída assim que o pagamento é confirmado.

Multibanco: o plugin gera a entidade e a referência, mostra-as na página de agradecimento e inclui-as no email da encomenda. A encomenda confirma-se automaticamente quando o pagamento é registado.

Confirmação automática

A confirmação dos pagamentos é feita por webhook: a Xpend notifica a tua loja e o plugin actualiza o estado da encomenda. A assinatura de cada webhook é verificada com o Segredo do Webhook.

Checkout em blocos

O plugin suporta o Block Checkout (checkout moderno) e o checkout clássico. Não é preciso configurar nada — funciona nos dois.

Reembolsos

Nesta versão, os reembolsos são tratados manualmente pela equipa Xpend. Contacta suporte@xpend.pt para pedir um reembolso.

UTMify e Facebook Ads

O plugin WooCommerce não envia trackingParameters (UTMs, fbclid) para a Xpend. Se usas UTMify + Meta Ads, a atribuição de campanhas via WooCommerce fica incompleta. Para tracking completo, integra via API custom ou envia UTMs manualmente no checkout (requer desenvolvimento adicional).

Resolução de problemas

  • Os métodos não aparecem no checkout: confirma que os gateways estão activos em WooCommerce → Definições → Pagamentos.
  • Erro de credenciais: verifica que colaste a chave secreta correcta (formato vps_live_…).
  • Encomenda não confirma: confirma que o URL de webhook foi configurado no backoffice Xpend. Vê os Logs em WooCommerce → Estado → Logs (origem xpend).