Natural Person 对象

在您的平台完成自然人注册后，需要对该客户进行反欺诈和 KYC 评估，这应通过 Natural Person 端点完成。提交的数据必须是最终数据，不得以任何方式更改，即在此流程之后，不应存在修改基本注册数据（如 CPF、姓名、出生日期等）的可能性。这对于保证以下两点至关重要：

反欺诈数据库中数据的一致性
真实的风险评估，避免后续操作中的欺诈行为

Natural Person 对象定义

Request Body

{
  "id": "12345678",
  "registration_id": "12345678",
  "registration_date": "2019-12-11T11:37:15.12-03:00",
  "client_category": "Premium User",
  "name": "John Sample",
  "document_number": "111.111.111-11",
  "birthdate": "1992-09-15",
  "gender": "male",
  "nationality": "BRA",
  "mother_name": "Maria Sample",
  "father_name": "John Sample",
  "monthly_income": 500000,
  "declared_assets": 7500000,
  "occupation": "Teacher",
  "emails":[
    {
      "email": "johnsample@test.com",
      "validation_type":"zaig_api",
      "validation_key": "e9f0de49-16fb-431e-be1a-ee4bf1096eda"
    }
  ],
  "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": "82589b39-e34f-44f9-b0fe-d8fc0ee6129c"
    }
  ],
  "source": {
    "channel": "app",
    "platform": "android",
    "ip":"255.201.26.1",
    "session_id": "54b8e3cf-15de-41e5-9305-0ecf059d6e2a"
  },
  "face":
  {
    "type":"zaig_sdk",
    "registration_key":"46f38cf4-07b2-4de6-93e9-64b51a68378a"
  }
}

所有注册的信息交换均使用以下对象定义。在某些情况下，为了简化实现并减少各方之间的数据流量，部分信息可以省略。

名称	类型	限制条件	描述
id	string	1–50 个字符	分析的标识符。该编号对于每次请求必须唯一 (必填)
registration_id	string	1–50 个字符	客户系统中注册的标识符。如需对同一注册进行多次分析，只需在不同分析中使用相同的 registration_id。未发送时将与 id 取相同值。
registration_date	datetime	ISO 8601 含时区	注册的日期和时间。格式：`YYYY-MM-DDTHH:MM:SS[.ffffff]±HH:MM` 或 `...Z`。示例：`2019-12-11T11:37:15.12-03:00` (必填)
client_category	string	1–100 个字符	根据您的平台分类或忠诚度计划划分的客户类别
name	string	1–500 个字符	被注册个人的完整姓名
document_number	string	格式 `XXX.XXX.XXX-XX`	个人的 CPF。必须恰好为 14 个字符，含点和连字符 (必填)
birthdate	date	格式 `YYYY-MM-DD`	个人的出生日期
gender	enum	`male` 或 `female`	个人的性别
nationality	string	3 个大写字母	采用 ISO 3166-1 alpha-3 的国籍代码。示例：`BRA`
mother_name	string	1–500 个字符	母亲的完整姓名
father_name	string	1–500 个字符	父亲的完整姓名
monthly_income	integer	1 至 100,000,000,000	月度税前收入，以分为单位（雷亚尔）
declared_assets	integer	1 至 100,000,000,000,000	申报资产，以分为单位（雷亚尔）
occupation	string	1–100 个字符	被注册个人的职业
emails	Email 列表	—	Email 类型对象列表，描述个人的电子邮件地址
documents	Document	—	CNH、RG 及其他身份证件类型的文件对象
address	Address	—	Address 类型对象，描述个人的居住地址
phones	Phone 列表	—	Phone 类型对象列表，包含个人的电话号码列表
source	Source	—	Source 类型对象，描述用于提交注册的应用程序信息
face	Face	—	Face 类型对象，描述注册时执行的人脸验证信息（如有）

字段格式说明

`registration_date`

必须遵循 ISO 8601 格式，且必须包含时区。有效值示例：

2019-12-11T11:37:15-03:00        （无秒级小数，带时区偏移）
2019-12-11T11:37:15.123456-03:00 （带秒级小数，最多 6 位）
2019-12-11T14:37:15Z             （UTC 时间）

该字段不接受不含时区的日期（例如 2019-12-11T11:37:15 为无效值）。

`document_number` — CPF

CPF 必须带标点发送，格式为 XXX.XXX.XXX-XX，其中每个 X 为数字。字段长度恰好为 14 个字符。

有效示例：123.456.789-09

`birthdate`

日期格式为 YYYY-MM-DD（年-月-日），符合 ISO 8601 标准。

有效示例：1992-09-15

`nationality`

遵循 ISO 3166-1 alpha-3 标准的 3 位大写字母国家代码。

示例：BRA（巴西）、USA（美国）、ARG（阿根廷）。

`monthly_income` 与 `declared_assets`

两个字段均为整数，表示以**分（雷亚尔）**为单位的货币金额。将雷亚尔转换为所需格式时，乘以 100 即可。

示例：BRL 5,000.00 → 500000

提交 Natural Person

Request Body

  {
    "id": "12345",
    ...
  }

Response Body

  {
    "id": "12345",
    "analysis_status": "automatically_approved",
    "reason": "rule_decision_enum"
  }

要对注册进行评估，只需将 Natural Person 类型的对象发送到以下端点，并相应设置参数标志：

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

参数 analyze 用于标识所提交的注册是否应由 QI Tech 的算法进行分析。如果提交注册时该参数值为 false，则不会对其进行分析或计费，但其数据将被 QI Tech 的算法用于未来的分析。该参数的默认值为 true，因此只有明确以 false 标志提交的注册才不会被分析。