Nossas APIs

Esse portal contém informações para lhe ajudar a integrar com nossas APIs.

Objetivo

Esta documentação orienta a implementação de um conjunto de APIs da MOVA, desde a alimentação de bases e criação da cotação, até a formalização e assinatura da proposta, dando acesso a diversos tipos de "Produtos de Crédito".

Sobre o Setup:

Criação do Produto de Crédito

A plataforma MOVA conta com um sistema chamado "Plataforma BLOCS". Por meio desse sistema é possível criar novos produtos de crédito de forma imediata, com base em templates disponíveis, chamados de "Blueprints". Esses templates contemplam produtos tanto para pessoas físicas quanto para pessoas jurídicas.

Um "Produto de Crédito" funciona como uma esteira operacional própria, de tal forma que a gestão de cada um deles dentro da MOVA pode ser segregada. Por este motivo cada cliente que contrata um desses produtos pode receber o respectivo "Código de Produto" exclusivo ("product_id").

Uma vez identificada a demanda do Requisitante por nossa equipe comercial e de produtos, é definido o "Blueprint" a ser utilizado e então a criação do produto é comandada na plataforma.

Uma vez criado o "Produto de Crédito", entendido como sendo o fluxo operacional do mesmo, será executada a configuração e parametrização do "Motor de Crédito e Antifraude" que processará as informações da Cotação, conforme pertinente a cada contexto.

Um mesmo Requisitante poderá ter diversos "Produtos de Crédito" e, portanto, mais de um product_id.

Ressaltamos que, além de execução de fluxos mais complexos, o conceito de "Produto de Crédito" inclui o envio de Cotações para simples consulta de Birôs e Bases de crédito, uma vez previamente coletadas as autorizações e consentimentos pelo objeto da análise.

API Key

A MOVA irá fornecer, por meio de nossa equipe de atendimento, uma "Api Key", ou mais, para o Requisitante. A "Api Key" será autenticada em cada requisição, devendo ser enviada no "Header" da chamada.

Código do Cliente

Além da "Api Key", a MOVA disponibilizará, por meio de nossa equipe de atendimento, um "Código de Cliente" ("mova-client-id"). Esse código é único por Requisitante.

O "mova-client-id" será autenticado em cada requisição, também devendo ser enviado no "Header" da chamada.

O objetivo desse código, gerado aleatoriamente e usualmente com 36 caracteres alfanuméricos, é garantir, em conjunto com a Api Key, que o Requisitante de fato possui acesso ao "Produto de Crédito" requisitado.

Ou seja, por meio de diferentes pontos de autenticação, é garantido que única e exclusivamente Requisitantes autorizados terão acesso à criação de Cotações dos respectivos "Produtos de Crédito".

Código do Produto

Além da "Api Key" e do "mova-client-id" ("Código do Cliente"), a MOVA disponibilizará, por meio de nossa equipe de atendimento, um "Código do Produto" ("product_id") relativo ao "Produto de Crédito" do Cliente.

Esse "Código do Produto" deve ser enviado no payload da chamada, no campo de "product_id".

Portanto, a chamada somente será recebida com sucesso caso a "Api Key", o "Código do Cliente" e o "Código do Produto" estejam corretos e compatíveis.

Esse "Código do Produto" ("product_id"), quando enviado, tem o objetivo de identificar qual "Produto de Crédito" está sendo acionado e, portanto, vincular ao mesmo a chamada em pauta.

Esse "Código do Produto" será amplamente utilizado nos controles da Plataforma, inclusive para geração de relatórios de reportes de acompanhamento.

Considerações Gerais

Tendo em vista as potenciais particularidades de determinado "Produto de Crédito" e eventuais customizações, ressaltamos que determinadas informações aqui apresentadas podem variar em função de contexto e configurações acordadas. Para estes casos, as partes devem providenciar uma versão de documentação específica, a fim de contemplar as referidas eventuais variações.

Ajuda

Estamos aqui para lhe ajudar da melhor forma ;)

Entre em contato conosco aqui