---
title: "风险验证-个人信息变更"
method: POST
path: "/fraud/identity/v2"
---

# 风险验证-个人信息变更

`POST /fraud/identity/v2`

## Request body

- object
  - `channel` string, required — 渠道标识：由 TD 分配
  - `session_id` string, required — 会话 ID：会话 ID 是网站服务器为特定用户在访问期间分配的唯一标识，通常可以用 Cookie、表单字段或 URL 的形式存储
  - `decision_event` 'modify', required — 风险验证时的业务节点：枚举值
  - `event_time` string, required — 业务真实发生时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00
  - `account_id` string, required — 账户 ID
  - `terminal` object, required — 终端信息
    - `black_box` string — 终端设备信息凭证：从 TD 终端安全 SDK 获取
    - `ip` string — 公网 IP 地址：支持 IPV4 和 IPV6
  - `ext` string, json — 扩展信息：与 TD 约定好的扩展信息
  - `event_detail` object, required — 业务事件信息
    - `account` object — 变更后的账户信息
      - `account_id` string, required — 账户 ID
      - `register_time` string, required — 账户注册（创建）时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00
      - `login_time` string, required — 账户最近一次登录时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:25:50.521+07:00
      - `phone` object — 账户手机信息
        - `country_code` string, required — 国家区号：符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
        - `phone_number` string, required — 手机号 / 电话号码：不含 + 号和前缀
      - `email` string — 账户邮箱
    - `profile` object — 新建或变更后的个人资料
      - `person` object — 个人基本信息
        - `name` object — 名称
          - `first_name` string — 名
          - `middle_name` string — 中间名
          - `last_name` string — 姓
          - `nickname` string — 昵称
        - `sex` 'male' | 'female' — 性别：枚举值
        - `birthdate` string — 出生日期：格式：YYYY-MM-DD ，例如 1998-01-01
      - `address` object — 个人地址（所在地）
        - `country` string, required — 国家：两位国家码，符合 ISO 3166 标准
        - `region` string, required — 省 / 州 / 地区
        - `city` string, required — 城市
        - `district` string — 区县
        - `detail` string — 详细地址
        - `zip_code` string — 邮政编码
      - `education` 'doctorate' | 'master' | 'bachelor' | 'junior_college' | 'high_school' | 'middle_school' | 'below_middle_school' — 学历
      - `profession` string — 职业
      - `annual_income` object — 年收入
        - `currency` string, required — 原始金额货币类型：3 字母编码，符合 ISO 4217 标准
        - `amount_local` number, double, required — 原始金额
        - `amount_usd` string — 金额（美金）：将原始金额经过汇率换算后的美金金额
        - `amount_cny` string — 金额（人民币）：将原始金额经过汇率换算后的人民币金额

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/trustdecision/apis/device-fingerprint-api-cn-query.md) · [All operations](https://skmtc.dev/trustdecision/apis/device-fingerprint-api-cn-query/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trustdecision/device-fingerprint-api-cn-query/revisions/e894dd0297ae/schema)