---
title: "风险验证-注册"
method: POST
path: "/fraud/identity/v2"
---

# 风险验证-注册

`POST /fraud/identity/v2`

## Request

- Base URL: `https://cn.apitd.net`
- URL: `https://cn.apitd.net/fraud/identity/v2`
- Auth: API key in query parameter `partner_code` and API key in query parameter `partner_key`

## Request body

- object
  - `channel` string, required: 渠道标识：由 TD 分配
  - `session_id` string, required: 会话 ID：会话 ID 是网站服务器为特定用户在访问期间分配的唯一标识，通常可以用 Cookie、表单字段或 URL 的形式存储
  - `decision_event` 'register', 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: 金额（人民币）：将原始金额经过汇率换算后的人民币金额
    - `invite` object: 邀请信息
      - `inviter_id` string: 邀请人账户 ID
      - `inviter_phone` object: 邀请人手机信息
        - `country_code` string, required: 国家区号：符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
        - `phone_number` string, required: 手机号 / 电话号码：不含 + 号和前缀
      - `invite_code` string: 邀请码
      - `invite_medium` string: 邀请媒介：例如 WeChat、Facebook、Twitter 等

## Response `200`

200

- object

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/trustdecision/apis/anti-fraud-decision-api-cn-register.md) - [All operations](https://skmtc.dev/trustdecision/apis/anti-fraud-decision-api-cn-register/llms.txt) - [OpenAPI document](https://skmtc.dev/trustdecision/apis/anti-fraud-decision-api-cn-register/revisions/d0cb8abea39b?raw)