Saltar para o conteúdo
Logótipo SIBS e MB WAY

Pagamentos

Integração SIBS e MB WAY

Recebe MB WAY, Multibanco e cartão diretamente pelo SIBS Gateway, sem intermediário, com webhooks e estados verificados.

Visão geral

SIBS e MB WAY

A SIBS gere a rede Multibanco e o MB WAY, e o SIBS Gateway permite a um comerciante receber estes métodos diretamente, através do banco com que tem contrato de aceitação, sem passar por um agregador.

A integração com o SIBS Gateway é mais exigente do que com um agregador: as notificações chegam cifradas, têm de ser decifradas com o segredo do webhook e respondidas no formato certo, senão a SIBS volta a enviá-las. A Tejobit trata dessa parte e confirma o estado final na API de estado antes de dar uma venda como paga.

Faz sentido para empresas com volume que já negociaram condições com o banco, ou que querem o MB WAY integrado no próprio checkout, numa app ou num terminal de self-service.

Casos de uso

Para que serve

  • Cadeia de restaurantes com encomendas online pagas por MB WAY no próprio site
  • Loja com volume suficiente para negociar comissões diretamente com o banco
  • Operador de transportes ou parques que vende bilhetes numa app própria
  • Empresa de serviços que envia links de pagamento com MB WAY, Multibanco e cartão
IN

O que a ligação escuta

  • Webhook do SIBS Gateway para pagamentos MB WAY, referências geradas e referências pagas
  • Eventos de captura em pagamentos com cartão feitos em dois passos
  • Nova encomenda ou fatura no sistema de origem
OUT

O que a ligação faz

  • Criar o checkout no SIBS Gateway com os métodos ativos na conta
  • Pedir o pagamento MB WAY para o número de telemóvel do cliente
  • Gerar referências Multibanco com data limite
  • Decifrar e responder às notificações e confirmar o estado na API
  • Marcar a venda como paga e pedir a fatura ao programa certificado

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Contrato de aceitação com um banco e acesso ao SIBS Gateway (credenciais do terminal e token)
  • Segredo do webhook e URL de notificação definidos no backoffice SIBS
  • Os métodos de pagamento ativos e as regras de validade das referências
  • Acesso ao site, app ou back-office onde a cobrança começa

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • O acesso ao SIBS Gateway passa pelo banco e pode levar algumas semanas a ficar ativo
  • Há um ambiente de testes separado e a passagem a produção exige validação
  • A SIBS processa pagamentos; faturas e comunicação à AT ficam no software certificado

Perguntas frequentes

Antes de começar

Porque usar o SIBS Gateway e não um agregador?

Com volume alto, as comissões negociadas com o banco costumam compensar, e o dinheiro chega pelo circuito do banco. Para volumes pequenos, um agregador como a IfthenPay é normalmente mais simples.

As notificações da SIBS são de confiança?

Chegam cifradas com AES-GCM e só se leem com o segredo da conta. Mesmo assim, a ligação confirma o estado na API antes de mudar a encomenda, como a SIBS recomenda.

Também serve para pagamentos por link?

Sim. A ligação gera o pedido de pagamento, envia o link ao cliente por email ou SMS e acompanha o estado até ao fim.

Ativar a integração SIBS e MB WAY?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.