Quotation API

This API is the gateway to running a "Credit Product" flow.

The "Quotation API" is intended to create a quotation for a specific user ("borrower"). Creating a quotation means processing the information received in order to return the result of a credit analysis, which may include anti-fraud, anti-money laundering ("AML") and "know you customer" ("KYC").

This result can take different values and formats. We highlight the following "response_type":

  • (i) "RETORNO_COTACAO_APROVADA" (Aproved Quotation);
  • (ii) "RETORNO_COTACAO_REPROVADA" (Failed Quotation);
  • (iii) "RETORNO_COTACAO_PENDENTE" (Pendding Quotation); or
  • (iv) RETORNO_COTACAO_RECEBIDA" (Received Quotation).

The returns RETORNO_COTACAO_APROVADA and RETORNO_COTACAO_REPROVADA naturally indicate approved and disapproved operations, respectively.

For a "RETORNO_COTACAO_APROVADA", the "Installs Options" are still returned, through the "installments_options" field.

The RETURN_QUOTACAO_PENDENTE, indicates an operation that has "Credit Engine" active, however, whose credit analysis, based on the policies, was directed to credit analysis, without achieving automatic approval.

The RETORNO_COTACAO_RECEBIDA, finally, indicates an operation was properly received and, according to the product's configuration, it does not have an active "Credit Engine" and, therefore, the return will delay.

As detailed below, the Quotation API can also be used to return information from Bureaus and Credit Bases, once the necessary authorizations have been collected by the research object.

Response Types

The return of Quotation results can be performed Synchronously or Asynchronous (via Callback, also referred to as like Webhook). For both cases the returned content is similar.

To receive this synchronous response, just send the "sync" parameter in the Header of the request, indicating "true" in the respective header value. If "false" or empty is indicated the Asynchronous configuration for the request will be considered.

Thus, the MOVA system allows the configuration of the type of response according to the need of the API consumer Client ("Requester"). So this configuration can be different per request, a feature that allows, for example, to send a batch of Quotations in order to an Asynchronous "Pre-Approval" in batch, at the same time as the same "Credit Product" runs in Synchronous format when calls arrive directly through the credit applicant's flow.

Important to mention that request via Webhook does not mean that it will take longer. That is, the SLA (“Service Level Agreement”) via Webhook can be similar to the Synchronous return. With this, we reinforce that the definition of the "type of response" depends on other variables, such as the infrastructure of the "Requester", expected costs, as well as expected volumes and consumption peaks. Finally, we clarify that the option for the Synchronous response does not stop us from returning the response via Webhook at the same time, if it makes sense in the context.

Credit Engine

To perform the analysis referred to in the above paragraphs and return the "Quotation Result", MOVA relies on a proprietary automation tool for the Credit Mat and Credit Engine ("Credit Engine"). This tool allows the implementation of decision rules and criteria and can run a "Decision Tree" as well as derive the Score and Rating of a Quote.

The Credit Engine is connected to several credit bases and bureaus, such as Serasa and SCR from the Brzil Central Bank, including several anti-fraud, AML and KYC tools.

The variables and criteria to be analyzed and processed in order to define the approval or disapproval of a Quotation ("Credit Policy") can be parameterized in a customized way, according to the context of each "Credit Product".

This MOVA system allows the inclusion of customized external databases in the Credit Engine, allowing information held by the originator to be analyzed automatically, within the scope of the automated "Credit Policy", provided that the user has duly authorized analysis.

Finally, we add that in the "Decision Tree" process, external analyzes can be integrated. In other words, the internal MOVA Credit Engine can be compatible with external credit engines or scores, combining with third-party analysis or approval. For this eventual joint action, prior integration work with these third parties may be necessary, to be agreed in advance with MOVA.

Integration

There is an example to consume the API, or click here to follow the full documentation.

application/json
{
  • "request_info": {
    },
  • "financial_info": {
    },
  • "financial_complement_info": {
    },
  • "borrower_info": {
    },
  • "natural_borrower_complement_info": {
    },
  • "legal_borrower_complement_info": {
    },
  • "legal_borrower_representatives": {
    },
  • "natural_guarantors_info": [
    ],
  • "disbursement_info": {
    },
  • "documents": {},
  • "operation_tag_identifiers": [
    ],
  • "operator_id": "Nzc4eGZmNE9DTmpRQlI4Sk5VdlFqQT09OjpOBjKhVe2OrluTHv855+9I",
  • "additional_fields": {
    }
}

Document historic

VersionDataNotes
1.02022-06-20First versiom
1.12022-06-23disbursement_info schemes
1.22022-07-27Renamed o header mova_client_id para mova-client-id Refactor on api_version to 'x.y.z' where x,y e z are integers. Obj:'spouse' from 'region' to 'state'.Obj:'gender' - capitalize. Obj:'id_document' - capitalize. Removed 'data' from PostQuotationRequest
1.32022-08-05Added production url. Refactor on message 403.
1.42022-08-10Renomeando Schemas, exceto WebHooks para inglês. Refactor example details erro 422. Refactor type installments_option_id from number to string.
1.52022-08-19On field marital_status changed value of 'OUTROS' to 'Outros' Object document_number removed '-' from examples cause punctuation is not allowed.
1.62022-08-25Added the field individual_custom_installments
1.72022-09-05Ajusted schema 'error'.