N.º da lição
LIÇÃO-PT-001
🇵🇹
PT
Data
2026-05-26

Lição 01 de 08 · Pagamentos

PublicadaPushSMS

MBWay: confirmações de pagamentos em segundos para Millennium, CGD, Novo Banco, Santander PT e BPI

MMBWay (operada pela SIBS) atingiu ~70% de adoção entre adultos portugueses, sendo o canal dominante para P2P e merchant payments. Millennium BCP, Caixa Geral de Depósitos, Novo Banco, Santander Portugal, BPI, Crédito Agrícola e Bankinter integram nativamente. 4notify confirma transações aos clientes em segundos com identidade do contraente e valor.

Contexto

MBWay já mostra um popup instantâneo na sua app, mas o comerciante precisa de uma comunicação separada no seu próprio canal para CRM, retention e custom branding. Sem isso, o cliente não associa a compra ao seu negócio.

Quadro legal

Decreto-Lei n.º 91/2018 — Serviços de pagamento

Implementação portuguesa da PSD2; notificação imediata em meio durável obrigatória.

Banco de Portugal — Aviso 7/2022

Regras para confirmações de pagamento instantâneo, incluindo VoP.

SIBS Merchant API Terms

SLA 99,95% uptime, webhook assinado, signing key rotation a cada 90 dias.

Lição (passos)

Webhook SIBS Merchant API

SIBS envia evento de pagamento para o 4notify dentro de 1s após clearing. Payload contém merchant_id, amount, customer_ref, payment_id.

Templates por tipo de transação

Seis templates: purchase_success, refund_issued, mbway_chargeback, pending_authorization, p2p_received, recurring_renewal. Bilingual pt/en.

Mascaramento IBAN/NIF no SMS

SMS mostra apenas últimos 4 dígitos do IBAN do contraente; NIF nunca aparece. IBAN completo disponível na app após autenticação.

Push + SMS dual-channel

Push primeiro para app users; SMS fallback dentro de 5s se não confirmado. Email para valores >€2.000 como registo durável.

Código

json
{
  "event": "mbway.payment.completed",
  "template": "mbway_purchase",
  "payment_id": "PT-MBW-20260526-A4F1",
  "amount": 89.50, "currency": "EUR",
  "merchant": "Loja Acme Portugal Lda",
  "counterparty": { "name_masked": "Joa*** Sil***", "iban_last4": "9821" },
  "channels": ["push", "sms"],
  "recipient": { "client_id": "MBCP-PT-204918", "phone": "+351912345678" },
  "compliance": { "psd2_durable_medium": true, "sibs_signing_key": "v2026Q2" }
}

Mensagem-exemplo

SMS

Loja Acme: Pagamento MBWay 89,50 EUR confirmado. Ref ORD-2026-481923. Obrigado!

Lista de verificação

Pedido de acesso SIBS Merchant API submetido
Webhook signature verification (HMAC SHA-256) ativo
Templates pt/en com escape seguro de placeholders
P99 latency end-to-end <5s validado
Retenção de 5 anos para registos de pagamento

Diferenciador 4notify

Integração nativa SIBS Merchant API + mascaramento automático IBAN/NIF — em conformidade com Banco de Portugal Aviso 7/2022 desde a primeira mensagem.