We will explain below the SCR collection flow using external authorization, obtained through your own journey.
Due to Brazilian banking secrecy laws, it is mandatory to obtain the client’s explicit consent in order to access their information in the SCR (Credit Information System). For this reason, in our SCR query flow, authorization is a required step. This authorization can either be captured by us, QI Tech, or collected and sent by you, our partners.
When consent capture is performed by QI Tech (Natural Person):
In the case of a natural person, for QI Tech to send the consent request, it is sufficient to fill in the personal data of the individual in the CreditProposal
object. QI Tech will then send the consent request to the individual via email and, once authorized, will automatically perform the consultation and make the results available for credit analysis.
It is mandatory to include the fields document_number
, name
, and email
— if the request is sent via email — and the phone
object — if the request is sent via WhatsApp or SMS — in order to collect consent from a natural person through QI Tech.
When consent is captured by QI Tech (Legal Person):
If the consent is captured by our team, the integration process is straightforward and does not require major adjustments. After the request is sent—either manually or via API—, we automatically trigger the consent process, which is signed through QI Sign, our electronic signature platform. The signing link can be sent via SMS or email. Once the document is signed, the flow proceeds as normal.
For API integration, no additional information is needed for individuals. However, for legal entities, the following field must be included:
"id": "12345678",
"credit_request_date": "2021-03-31T10:30:00-03:00",
"legal_name": "QI Tech Tecnologia LTDA",
"document_number": "35.472.523/0001-15",
...
“scr_parameters": {
"signers": [
{
"document_number": "372.989.950-30",
"name": "Felipe Marques da Silva",
"email": "felipe.silva@qitech.com.br",
"phone": {
"number": "991722315",
"area_code": "16",
"international_dial_code": "55"
}
},
{
"document_number": "440.896.050-08",
"name": "Claudio Mattos",
"email": "claudiomattos@sample.com",
"phone": {
"number": "991722315",
"area_code": "16",
"international_dial_code": "55"
}
}
]
}
The "signers"
object must contain the information of the individuals who will sign the document. The signer must be a legal representative of the company.
When consent is captured by the partner (Legal Person):
If the partner collects the consent, the flow must be carried out via API, and the authorization information must be included in the request payload. In general, the additional fields are similar for individuals and legal entities, with the difference that the "signers"
object is only required for legal entities. Below is an example of the payload format and a description of its components:
"id": "12345678",
"credit_request_date": "2021-03-31T10:30:00-03:00",
"legal_name": "QI Tech Tecnologia LTDA",
"document_number": "35.472.523/0001-15",
...
"signers": [
{
"document_number": "372.989.950-30",
"name": "Felipe Marques da Silva",
"email": "felipe.silva@qitech.com.br",
"phone": {
"number": "991722315",
"area_code": "16",
"international_dial_code": "55"
}
},
{
"document_number": "440.896.050-08",
"name": "Claudio Mattos",
"email": "claudiomattos@sample.com",
"phone": {
"number": "991722315",
"area_code": "16",
"international_dial_code": "55"
}
}
],
"signature_evidence": {
"ip_address": "179.104.42.245",
"session_id": "ddb1d063-4fdf-4330-af9c-3316e9142ff3",
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQSflKxwRJSMeKKF2QT4fwpMeJf36PO6yJV_adQssw5d",
"additional_data": {
...
},
"signed_term": {
"raw_text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas elementum erat et tempus dapibus. Donec eu sapien tortor. Pellentesque et tortor eget erat pulvinar mattis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin ornare diam arcu, sit amet auctor lorem varius quis. Ut pretium venenatis magna sed ultrices. Donec quis tortor odi."
}
}
}
- The
"signers"
field must include information about the signatory representing the legal entity. This person must be a legal representative of the company. The"signature_evidence"
object holds data regarding the collection and storage of the consent. If auditing of the signed terms is needed, the fields"session_id"
and"additional_data"
should contain information to locate the consent. We recommend that"session_id"
contains a unique identifier for the consent and that"additional_data"
includes a link to access the consent (e.g., in a bucket or drive). - The
"ip_address"
field must contain the IP address of the machine where the signature was performed. - The
"access_token"
field should provide the token used to sign the document. - The
"signed_term"
must contain the full text of the collected consent.
After the request with consent information is submitted, the process will start and the SCR data will be displayed in the Credit Analysis.
When consent capture is performed by the partner (Natural Person):
The payload follows the same structure as the one used for legal entities, but without the signers
object.
"id": "678",
"credit_request_date": "2021-03-31T10:30:00-03:00",
"name": "Victor Silva Barbosa",
"document_number": "199.208.915-92",
...
"scr_parameters": {
"signature_evidence": {
"ip_address": "1245",79.104.42.
"session_id": "ddb1d063-4fdf-4330-af9c-3316e9142ff3",
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQSflKxwRJSMeKKF2QT4fwpMeJf36PO6yJV_adQssw5d",
"additional_data": {
...
},
"signed_term": {
"raw_text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas elementum erat et tempus dapibus. Donec eu sapien tortor. Pellentesque et tortor eget erat pulvinar mattis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin ornare diam arcu, sit amet auctor lorem varius quis. Ut pretium venenatis magna sed ultrices. Donec quis tortor odi."
}
}
}