Skip to main content

Legal Person Object

At the end of registering a company on your platform, it is necessary to perform the fraud and KYC assessment for this entity, which must be carried out through the Legal Person endpoint. The data submitted must be final and must not be changed under any circumstances. That is, after this process, it should not be possible to modify basic registration data such as CNPJ, Company Name, Incorporation Date, and others. This is very important to ensure two key points:

  • Consistency of the data in the Anti-Fraud database
  • Realistic risk assessment, avoiding fraud in future operations
Request Body
{
"id": "12345678",
"registration_id": "12345678",
"registration_date": "2019-12-11T11:37:15.12-03:00",
"client_category" : "Premium Account",
"legal_name": "John's Company",
"trading_name": "John's Barbershop",
"document_number": "11.111.111/0001-11",
"foundation_date": "1992-09-15",
"website": "www.johnsbarbershop.com.br",
"activity": "Barber Shops",
"activity_code": "96.02-5-01",
"merchant_category_code": "0742",
"tier" : "epp",
"annual_revenues": 72000000,
"emails":[
{
"email": "johnsample@test.com",
"validation_type":"zaig_api",
"validation_key": "ccc4b4b4-f91c-4475-8290-07152550aefc"
}
],
"documents": {
"ie": {
"number": "388.108.598.269",
"issuer": "JUCESP",
"issuer_state": "SP",
"issuance_date":"2002-01-12",
"validation_type": "zaig_api",
"ocr_key": "c64627db-1ba4-48b6-979d-06222a25d5e9"
},
"company_statute": {
"ocr_key": "60ed79c4-5aba-4cc7-aebb-5de5f92b7d0d"
}
},
"address": {
"street": "Rua do Teste",
"number": "111",
"neighborhood": "Bairro do Exemplo",
"city": "Aparecida de Goiânia",
"uf": "GO",
"complement": "Térreo",
"postal_code": "00000-000",
"country": "BRA",
"validation_type": "visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "1",
"area_code": "11",
"number": "999999999",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "82473dec-8e14-4570-997a-59652818c908"
}
],
"source": {
"channel": "app",
"platform": "android",
"ip":"201.6.142.66",
"session_id": "c90ad2df-7307-4f82-8938-1da81dff2be6"
},
"legal_representatives": [
{
"name": "Frederic Attorney",
"document_number": "111.111.111-11",
"birthdate": "1987-06-12",
"gender": "male",
"nationality": "BRA",
"mother_name": "Jackie Attorney Mother",
"occupation": "Accountant",
"emails":[
{
"email": "frederic@attorney.com",
"validation_type":"zaig_api",
"validation_key": "d174d522-6003-4b05-adb2-e92e92632c67"
}
],
"documents": {
"letter_of_attorney": {
"ocr_key": "6972894d-d2ef-4b5f-b54f-10f178bf3e5d"
},
"cnh": {
"register_number": "05163811694",
"issuer_state": "PR",
"first_issuance_date":"2011-03-21",
"issuance_date":"2016-06-29",
"expiration_date":"2021-06-25",
"category": "AB",
"validation_type":"zaig_sdk",
"ocr_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
}
},
"address": {
"street": "Avenida de Exemplo",
"number": "99",
"neighborhood": "Vila do Exemplo",
"city": "Jundiaí",
"uf": "SP",
"complement": "Ap 82",
"postal_code": "00000-000",
"country": "BRA",
"validation_type":"visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "55",
"area_code": "11",
"number": "999998877",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "e390d2b3-cb71-4991-9d94-1b7f8b43a04e"
}
],
"source": {
"channel": "app",
"platform": "ios",
"ip":"175.92.122.2",
"session_id": "93c68588-7a41-472f-95b3-835ea6ee1ede"
},
"face":
{
"type":"zaig_sdk",
"registration_key":"d2677a8c-d575-44e1-a54d-ec00f9310f34"
}
}
],
"partners": [
{
"name": "John Partner",
"document_number": "111.111.111-11",
"birthdate": "1992-09-15",
"gender": "male",
"nationality": "BRA",
"mother_name": "Maria Partner's Mother",
"occupation": "Teacher",
"emails":[
{
"email": "johnsample@test.com",
"validation_type":"zaig_api",
"validation_key": "1fac6f8c-1a16-4a12-9afc-9a2d9ae0a31e"
}
],
"documents": {
"rg": {
"number": "4.366.477-8",
"issuer": "II",
"issuer_state": "PR",
"issuance_date":"2002-01-12",
"validation_type":"zaig_sdk",
"ocr_front_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76",
"ocr_back_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
},
"cnh": {
"register_number": "05163811694",
"issuer_state": "PR",
"first_issuance_date":"2011-03-21",
"issuance_date":"2016-06-29",
"expiration_date":"2021-06-25",
"category": "AB",
"validation_type":"zaig_sdk",
"ocr_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
}
},
"address": {
"street": "Rua do Teste",
"number": "111",
"neighborhood": "Bairro do Exemplo",
"city": "Aparecida de Goiânia",
"uf": "GO",
"complement": "Térreo",
"postal_code": "00000-000",
"country": "BRA",
"validation_type":"visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "1",
"area_code": "11",
"number": "999999999",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "d1713959-4ae4-4180-befc-6931c658e908"
}
],
"source": {
"channel": "app",
"platform": "android",
"ip":"255.201.26.1",
"session_id": "79d5e442-2cb7-4a9e-82c5-7fa3717d7ada"
},
"face":
{
"type":"zaig_sdk",
"registration_key":"a2b6ae92-1394-4f9b-b8ee-5be188f93609"
}
}
]
}

All data exchanges involving a registration use the following definition for this object. In some cases, to simplify implementation and reduce the data flow between parties, some information may be omitted.

nometipodescrição
idstringAnalysis identifier.
This number must be unique for each request (required)
registration_idstringIdentifier of the registration in the client's system. To perform more than one analysis for the same registration, simply use the same registration_id in different analyses. This field is optional and will have the same value as id when not provided.
registration_datedatetimeDate and time of registration (required)
client_categorystringClient category according to your platform classification or loyalty program
legal_namestringCorporate name of the company being registered
trading_namestringTrade name of the company being registered
document_numberstringCNPJ of the company being registered, with dots and dashes, according to the standard (required)
foundation_datedateCompany foundation date according to the standard
websitestringWebsite of the company being registered
activitystringBusiness sector of the company being registered
activity_codestringCNAE code of the company's activity (must be formatted as in the previous example)
merchant_category_codestringMCC (Merchant Category Code) for the activity sector according to card brands
tierstringCompany size
annual_revenuesintegerCompany's gross annual revenue in BRL cents
emailsList of EmailList of Email objects describing the company's email addresses
documentsDocumentDocument objects (State registration - ie, Articles of incorporation - company_statute)
addressAddressAddress object describing the company’s address
phonesList of PhoneList of Phone objects describing the company’s phone numbers
sourceSourceSource object describing the characteristics of the application used to send the registration
partnersList of PartnerList of Partner objects describing information about each of the company’s partners
legal_representativesList of Legal RepresentativesList of LegalRepresentative objects describing information about each of the company’s legal representatives
Request Body
  {
"id": "12345",
...
}
Response Body
  {
"id": "12345",
"analysis_status": "automatically_approved",
"reason": "rule_decision_enum"
}

To perform the evaluation of a Registration, simply send an object of type Legal Person to the following endpoint with the flag properly set:

POST https://api.caas.qitech.app/onboarding/legal_person?analyze=true

The analyze parameter is used to determine whether the submitted registration should be analyzed by QI Tech's algorithms. If a registration is sent with the parameter set to false, it will not be analyzed or charged, but its data will still be considered by QI Tech's algorithms for future evaluations. The default value for this parameter is true, meaning that only registrations explicitly sent with the false flag will not be analyzed.