: 2019.20.39.5
: 26/09/2019
Novo sistema de Referências MB e MBWay
Página 1 / 0
Já há muito tempo que o ESPORT e o EEDUCA disponibilizam o Pagamento de Serviços que lhe permite emitir periodicamente, e de uma "assentada" uma referência Multibanco para cada um dos seus utentes, permitindo-lhes utilizar o homebanking ou as maquinas ATM espalhadas por todo o país para poderem fazer o pagamento das suas mensalidades sem terem de se dirigir aos serviços administrativos da sua instalação.
Contudo, através de uma parceria de proximidade com a SIBS, a CEDIS disponibiliza agora nos seus packages ESPORT e EEDUCA novas funcionalidades que permitem às entidades implementar uma nova forma de trabalho com as referências MB bem como disponibilizar o MBWay como forma de pagamento também em ambas as plataformas.
Nas secções seguintes apresentamos estas novas formas de trabalho e de que forma elas podem melhorar o seu serviço
- Diferenças entre a anterior emissão de Referências MB e a atual
- Requisitos para a emissão de Referências MB
- Como configurar para emitir Referências MB pelo novo processo
- Implementar o MBWay
- Requisitos para a utilização do MBWay
- Como configurar para permitir pagamentos por MBWay
- Cuidados a ter
- Utilizar as Referências MB e o MBWay no ESPORT
1. Diferenças entre a anterior emissão de Referências MB e a atual
A primeira grande diferença reside no facto de deixar de haver necessidade de produzir um ficheiro na plataforma interna do ESPORT e entregá-lo ao Banco (ou à SIBS) através do backoffice. Isto acontece porque as Referências são emitidas imediatamente pela SIBS quando o software faz o pedido à API da SIBS.
Por outro lado, deixa de ser necessário descarregar no software os ficheiros enviados pelo Banco (SIBS) um vez que assim que o utente paga no seu homebanking ou numa máquina ATM, a indicação do pagamento é imediatamente dada ao software sendo emitida a respectiva factura/recibo ou recibo, conforme o caso.
Esta diferente forma de trabalhar traduz-se de imediato numa grande economia de tempo para o utilizador que passa apenas a ter "de carregar no botão do ESPORT" para emitir os documentos com as respectivas referências MB e enviar a informação para cada um dos utentes, desaparecendo todo o trabalho associado ao transporte de ficheiros entre o Banco e a aplicação.
Por outro lado, uma vez que as referências MB são obtidas a partir da API da SIBS sempre que são necessárias, o utente passa a ter uma referência MB diferente de mês para mês, ao contrário do que acontecia anteriormente.
Outra questão relevante para a instalação e para os utentes advém do facto de que como tanto a emissão como a resposta são imediatas, passa a ser possível utilizar as Referências MB para o pagamento de alguns tipos de serviços que até à data estavam vedados pela morosidade que o processo de envio e recepção de ficheiros provocava. Assim sendo, a emissão de Referências MB passou a ser possível também na Marcação de Recintos e e na Marcação de Serviços, bem como directamente nas cobranças. Nestes casos, é assinalada a dívida correspondente ao serviço que o utente está a querer pagar e o documento só é emitido quando o utente paga efectivamente numa máquina ATM ou em homebanking.
2. Requisitos para a emissão de Referências MB
Existem alguns requisitos que o seu sistema tem de ter para poder utilizar esta forma de emissão de Referências Multibanco:
- Em primeiro lugar deve verificar junto do seu banco se estes disponibilizam contratualmente a plataforma digital da SIBS (Digital Payments Gateway) e contratualizá-la. Actualmente os seguintes bancos disponibilizam esta plataforma: BCP, BPI, CCA, CGD, Santander e UNICRE. Caso o seu banco não esteja entre estes, deve contactar a CEDIS para possíveis alternativas de funcionamento;
- Em segundo lugar, é necessário licenciar o módulo ESPORT, Integração de Sistema de Pagamento SIBS junto da CEDIS. Este módulo, disponibilizado a partir do ESPORT Ver. 2019.20.39.5 permite-lhe utilizar quer as Referências MB, quer o sistema de pagamento MBWay. Caso necessário, contacte a Área Comercial da CEDIS para mais informações;
- Em terceiro lugar, é necessário disponibilizar na sua rede um link acessível por parte da SIBS, em https (requer certificado para o domínio) com TLS 1.2, onde estará disponível a plataforma da CEDIS que recebe as indicações de pagamentos efectuados por parte da SIBS; Se o seu sistema ESPORT é disponibilizado em SaaS CEDIS não necessita de se preocupar com este requisito;
- Por fim, e após ter contratualizado o serviço com o seu Banco, este remeterá para si um conjunto de parâmetros de identificação e segurança que serão necessários para configurar o serviço, conforme indicado no ponto seguinte.
3. Como configurar para emitir Referências MB pelo novo processo
Depois de verificar que todos os requisitos estão validados, é necessário recolher os seguintes parâmetros que lhe foram enviados pelo seu banco num, ou em vários documentos/emails: o entity (número de entidade), o entityId (um valor do tipo 18b9f1ada7d843cc8d17a1c6663e5536) e o authHeader (designado pela SIBS como ACCESS TOKEN). O parâmetro paymentType deve ser preenchido com o valor PA.
Um outro parâmetro necessário, o secret, é obtido directamente no backoffice da SIBS, para os quais deverá também ter recebido credenciais e instruções de acesso.
Para dar estas indicações ao ESPORT, deve aceder a Parametrização, depois Tabelas e escolher, nas tabelas criticas, a opção Meios de Pagamento. Na lista que é apresentada, localize Pagamento de Serviços, edite, preencha os campos e clique em Gravar.
Após esta configuração o sistema estará pronto a funcionar com este novo tipo de Referências Multibanco em qualquer um dos pontos em que a aplicação o permite (Cobranças, Pagamento de Serviços, Marcação de Recintos e Marcação de Serviços).
4. Implementar o MBWay
A utilização do MBWay, pela sua natureza, serve como meio de pagamento para uma operação específica, como por exemplo, o pagamento de uma reserva de recinto ou de um serviço, ou mesmo de uma mensalidade dentro ou fora do prazo de pagamento.
Tomemos como exemplo o pagamento de uma marcação de recinto no portal do ESPORT... O utente efectua a marcação através do Portal e, depois de escolher o recinto e o horário pretendido, vê o valor que tem a pagar, sendo-lhe apresentado os meios de pagamento à disposição. Se escolher o MBWay, é-lhe perguntado em que número de telefone deseja receber o pedido de pagamento, sendo que o Utente pode optar por utilizar o que já tem na sua ficha de utente ou indicar outro. Prosseguindo com a operação, bastará abrir o MBWay no telemóvel para onde enviou o pedido e confirmar o pagamento através da aplicação de MBWay.
O MBWay também pode ser utilizado por um utilizador interno à organização dentro do ESPORT numa Cobrança, ou também numa Marcação de Recinto ou Serviço, sendo que o processo é exactamente o mesmo.
5. Requisitos para a utilização do MBWay
Os requisitos para a utilização do MBWay são exactamente os mesmos que os indicados para a emissão de Referências MB, embora alguns parâmetros sejam diferentes, nomeadamente o tipo de operação (paymentType), como indicado no ponto seguinte.
6. Como configurar para permitir pagamentos por MBWay
Tal como na configuração da emissão de Referências MB, é necessário recolher os parâmetros que lhe foram enviados pelo seu banco. Os parâmetros são os mesmos pelo que a configuração é idêntica, embora tendo em atenção que o parâmetro paymentType deve ser preenchido com o valor DB.
Para dar estas indicações ao ESPORT, deve aceder a Parametrização, depois Tabelas e escolher, nas tabelas críticas, a opção Meios de Pagamento. Na lista que é apresentada, localize MB Way, edite, preencha os campos e clique em Gravar tal como especificado no ponto 3. Como configurar para emitir Referências MB pelo novo processo.
Feita esta operação o sistema estará pronto e efectuar pagamentos por MBWay.
7. Cuidados a ter
No caso de ter uma aplicação a utilizar o Digital Payments Gateway apenas com um tipo de pagamento, bastará configurar uma ligação no backoffice da SIBS. No entanto, se tiver mais do que um meio de pagamento, deve utilizar um webhook por cada meio de pagamento. Para saber mais sobre o que é um webhook consulte a documentação de apoio do Digital Payments Gateway.
No caso de ter mais do que uma aplicação a utilizar o Digital Payments Gateway com um ou mais tipos de pagamento, deverá configurar um webhook por cada aplicação e meio de pagamento, mas deve solicitar à SIBS a indicação de valores diferentes para o parâmetro entityID. Esta situação revela-se necessária para que cada uma das aplicações não fique continuamente a receber informações de pagamento que são destinadas à outra aplicação.
8. Utilizar as Referências MB e o MBWay no ESPORT
Como já referimos, para além das emissões mensais de pagamento de serviços onde já se podia utilizar referências MB, estas podem ser usadas agora pontualmente na utilização diária do ESPORT, quer para facilitar a vida a um utente que se esqueceu da carteira (mas não do telemóvel :-) ), como para permitir o pagamento de um utente que está ao telefone a efetuar uma marcação, como ainda para emitir uma nova referência MB para um utente que deixou expirar a anterior que lhe tinha sido enviada. Todas estas situações são agora possíveis.
8.1. Pagar uma mensalidade através de uma Referência MB emitida na hora
Por exemplo, suponha que o utente se dirige à Secretaria para pagar uma mensalidade. O operador pode aceder à ficha do utente, selecionar o que o utente deseja pagar e indicar como meio de pagamento a opção Gerar Referência MB. Note que ao escolher este meio de pagamento, o botão onde se clica para normalmente emitir a Fatura/Recibo ou apenas Fatura assume a descrição Gerar Referência como apresentado na figura seguinte:
Clicando no botão Gerar Referência em baixo à esquerda o ESPORT irá invocar a API para obter uma Referência MB e de seguida irá apresentar o resultado obtido na figura seguinte. Para que o Utente saiba qual a referência, o montante e até que data pode pagar, é-lhe enviado um email e/ou um SMS com essas indicações. Note que por defeito o prazo de pagamento da referência é de 3 dias, embora possa ser aumentado ou reduzido por configuração.
8.2 Pagar uma marcação de recinto por MBWay
O processo para concluir uma marcação de um recinto ou de um serviço por MBWay é idêntico ao processo de pagamento em numerário, exceto no passo em que é indicada a forma de pagamento.
Neste passo, o utilizador deverá escolher o meio de pagamento MBWay como indicado na figura seguinte e depois clicar no botão Finalizar marcação. Ao faze-lo, o ESPORT irá solicitar a indicação do nº de telemóvel para onde o pedido de pagamento será enviado. Note-se que o utilizador pode optar por enviar o pedido para o nº de telemóvel que o Utente tem na ficha, assinalando a caixa indicada. No entanto, dependendo das permissões do utilizador relativamente ao RGPD, este poderá não ver o nº de telemóvel completo.
O Utente receberá no MBWay do telemóvel indicado o pedido de autorização para proceder ao pagamento indicado.
Note que em ambas as situações 8.1. e 8.2. o documento de faturação só é emitido após confirmação do pagamento por parte do utente, ou quando este paga a Referência MB no seu homebanking ou numa ATM, ou quando autoriza o pagamento no MBWay. Ao faze-lo a SIBS invoca a API do ESPORT e apenas nesta altura o documento é emitido, ficando assim o processo concluído sem qualquer interferência por parte do utilizador.
Contamos que estas novas funcionalidades tornem o atendimento mais ágil e célere na sua instalação.