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
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
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
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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.
Integrações relacionadas
Ver todas as integrações- Pagamentos
IfthenPay
Gera referências Multibanco e pedidos MB WAY e trata o callback de pagamento para fechar encomendas e faturas sozinho.
Desde 5 € /mês + IVA
Ver integração - Faturação
Vendus
Pedidos online, takeaway e vendas noutras plataformas passam a documentos na caixa certa do Vendus, com stock acertado.
Desde 5 € /mês + IVA
Ver integração - Faturação
Moloni
Cada venda paga noutro sistema passa a fatura no Moloni, na série certa e com o cliente identificado pelo NIF.
Desde 5 € /mês + IVA
Ver integração
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.