Integração do financeiro em um sistema externo

🚨 Esse é um artigo voltado para desenvolvedores que desejam integrar o menu Financeiro da Plataforma Rubeus com um sistema externo livremente.

REALIZANDO UMA INTEGRAÇÃO EXTERNA COM O MÓDULO FINANCEIRO

Além de todas nossas funcionalidades integradas diretamente com a Plataforma Rubeus, oferecemos a possibilidade de efetuar a integração do módulo Financeiro com sistemas externos. Neste artigo, conheceremos os passos necessários para efetuar a integração do Financeiro com estes sistemas.

Caso ainda não conheça as funcionalidades do módulo Financeiro do Rubeus, acesse nossos artigos na central.

🎯 CRIANDO UMA INTEGRAÇÃO COM O MÓDULO FINANCEIRO

Para utilização do link de pagamento Rubeus Pay de forma totalmente personalizada, devemos montar a seguinte URL e colocar os valores correspondentes a cada parâmetro:

https://apprbpayteste.apprbs.com.br/payment?iframe=0&dominio=https://dominio.apprbs.com.br/&canalPersonalizado=5&localOferta=2&contato=58&curso=3&registro=81&origem=14&itemPagamento=0

Assim, ao definir o link como demonstrado anteriormente, você poderá utilizá-lo para redirecionar um contato para a página de pagamento ou inseri-lo em um iframe.

Com este link, pode ser feito um redirecionamento ou inserido em um iframe dentro da página. Abaixo veremos um exemplo do uso de uma URL com iframe definido:

https://apprbpayteste.apprbs.com.br/payment?iframe=0&dominio=https://dominio.apprbs.com.br/&canalPersonalizado=5&localOferta=2&contato=58&curso=3&registro=81&origem=14&itemPagamento=0&iframe=1

Ao utilizar o valor 1 (iframe=1), você poderá usar o componente financeiro em seu iframe, de forma responsiva. Neste caso, toda vez que o iframe for redimensionado, será enviado um evento pra pagina “pai” com o valor atual da altura para que seja possível alterar dinamicamente.

Para deixar o iframe responsivo, é preciso colocar o código abaixo na página “pai” onde irá ficar o iframe:

   let iframePagamento = document.getElementById("ID-IFRAME");

   iframePagamento.style.border = 'none';

   function listenDown(msg) {

       var data = msg.data;

       switch (data.type) {

           case "HEIGHT":

               iframePagamento.style.height = `${data.height}px`;

               break;

       }

   }

   window.addEventListener("message", listenDown, false);

Exemplo com o código já inserido:

🛠️ CONFIGURAÇÃO DE ITENS DE PAGAMENTO

No menu do Financeiro temos a opção de itens de pagamento, que, basicamente, refere-se ao valor que se deseja ser cobrado para determinado registro, no momento do pagamento. Esse valor poderá ser utilizado de forma fixa ou através de um valor presente em um campo personalizado. Saiba mais.

Ao utilizar a integração personalizada, poderão ser selecionados um ou mais itens. Para isso, você deverá acessar as configurações avançadas de um modelo de formulário e acrescentar a chamada da função abaixo:

ActionsForm.getPaymentLinks(). 

Após efetuar a chamada da função, o retorno será parecido com o exemplo abaixo. Cada posição de seu array, será um link de pagamento gerado.

Objetos retornados pela função

💡 Lembre-se!

Só é possível fazer a chamada da função, após todos os dados serem enviados para a Plataforma Rubeus. Os dados serão enviados após concluir o preenchimento do seu formulário.

Dúvidas? Basta entrar em contato com o nosso time de Atendimento!😃