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	分析的标识符。该编号对于每次请求必须唯一 (必填)
registration_id	string	客户系统中注册的标识符。如需对同一注册进行多次分析，只需在不同分析中使用相同的 registration_id。该字段非必填，未发送时将与 id 取相同值。
registration_date	datetime	注册的日期和时间 (必填)
client_category	string	根据您的平台分类或忠诚度计划划分的客户类别
name	string	被注册个人的完整姓名
document_number	string	被注册个人的 CPF，含点和连字符，遵循标准格式 (必填)
birthdate	date	个人的出生日期，遵循标准格式
gender	enum	个人的性别：'male' 或 'female'
nationality	string	注册人的国籍，采用 ISO 3166-1 alpha-3 格式
mother_name	string	母亲的完整姓名
father_name	string	父亲的完整姓名
monthly_income	integer	月度税前收入，以分为单位
declared_assets	integer	申报资产，以分为单位
occupation	string	被注册个人的职业
emails	Email 列表	Email 类型对象列表，描述个人的电子邮件地址
documents	Document	CNH 和 RG 类型的文件对象
address	Address	Address 类型对象，描述个人的居住地址
phones	Phone 列表	Phone 类型对象列表，包含个人的电话号码列表
source	Source	Source 类型对象，描述用于提交注册的应用程序信息
face	Face	Face 类型对象，描述注册时执行的人脸验证信息（如有）

提交 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 标志提交的注册才不会被分析。

Natural Person 对象定义​

提交 Natural Person​

Natural Person 对象定义

提交 Natural Person