---
title: "风险验证-交易"
method: POST
path: "/fraud/transaction/v2"
---

# 风险验证-交易

`POST /fraud/transaction/v2`

## Request

- Base URL: `https://cn.apitd.net`
- URL: `https://cn.apitd.net/fraud/transaction/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` 'order_create', required: 风险验证时的业务节点：枚举值
  - `event_time` string, required: 业务真实发生时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00
  - `account_id` string: 账户 ID：当账户不存在时可不传
  - `order_id` string, required: 订单号
  - `terminal` object, required: 终端信息
    - `black_box` string: 终端设备信息凭证：从 TD 终端安全 SDK 获取
    - `ip` string: 公网 IP 地址：支持 IPV4 和 IPV6
  - `ext` string, json: 扩展信息：与 TD 约定好的扩展信息
  - `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: 账户邮箱
  - `order` object, required: 订单信息
    - `order_id` string, required: 订单号
    - `order_create_time` string, required: 下单时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:25:50.521+07:00
    - `merchandise_list` object[]: 商品列表
      - `merchandise_id` string, required: 商品 ID
      - `category_1` string, required: 商品一级类目
      - `category_2` string: 商品二级类目
      - `category_3` string: 商品三级类目
      - `name` string: 商品名称
      - `count` string: 商品数量
      - `unit_price` object: 商品单价
        - `currency` string, required: 原始金额货币类型：3 字母编码，符合 ISO 4217 标准
        - `amount_local` number, double, required: 原始金额
        - `amount_usd` string: 金额（美金）：将原始金额经过汇率换算后的美金金额
        - `amount_cny` string: 金额（人民币）：将原始金额经过汇率换算后的人民币金额
    - `amount` object, required: 订单总金额
      - `currency` string, required: 原始金额货币类型：3 字母编码，符合 ISO 4217 标准
      - `amount_local` number, double, required: 原始金额
      - `amount_usd` string: 金额（美金）：将原始金额经过汇率换算后的美金金额
      - `amount_cny` string: 金额（人民币）：将原始金额经过汇率换算后的人民币金额
    - `shipping` object: 收货信息
      - `address` object: 收货地址
        - `country` string, required: 国家：两位国家码，符合 ISO 3166 标准
        - `region` string, required: 省 / 州 / 地区
        - `city` string, required: 城市
        - `district` string: 区县
        - `detail` string: 详细地址
        - `zip_code` string: 邮政编码
      - `phone` object: 收货手机号
        - `country_code` string, required: 国家区号：符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
        - `phone_number` string, required: 手机号 / 电话号码：不含 + 号和前缀
      - `email` string: 收货邮箱
      - `consignee` object: 收货人
        - `first_name` string: 名
        - `middle_name` string: 中间名
        - `last_name` string: 姓
        - `nickname` string: 昵称
      - `method` 'logistics' | 'store_pickup': 收货方式
  - `payment` object: 支付信息
    - `payment_id` string, required: 支付流水号
    - `method` 'card' | 'ewallet' | 'bank_transfer' | 'cash_on_delivery' | 'bnpl' | 'other', required: 支付方式
    - `channel` string, required: 支付渠道：例如 worldpay、credorax、airwallex、apple_pay、checkout、ebanx、adyen、stripe、paypal、pacypay、alipay、wechat_pay、other
    - `amount` object, required: 支付金额
      - `currency` string, required: 原始金额货币类型：3 字母编码，符合 ISO 4217 标准
      - `amount_local` number, double, required: 原始金额
      - `amount_usd` string: 金额（美金）：将原始金额经过汇率换算后的美金金额
      - `amount_cny` string: 金额（人民币）：将原始金额经过汇率换算后的人民币金额
    - `card` object: 支付银行卡
      - `card_bin` string, required: 卡 bin
      - `last_four_digits` string, required: 卡最后四位
      - `card_number_length` integer, required: 卡号长度
      - `holder_name` object: 持卡人名称
        - `first_name` string: 名
        - `middle_name` string: 中间名
        - `last_name` string: 姓
        - `nickname` string: 昵称
      - `debit_or_credit` 'debit' | 'credit': 卡类型：枚举值
      - `issuer_region` string: 发卡国家或地区：两位国家码，符合 ISO 3166 标准
      - `expiration_date` string: 过期时间：格式：YYYY-MM ，例如 1998-01
    - `is_coupon_used` 'true' | 'false': 是否使用优惠券：枚举值
    - `coupons` object[]: 使用的优惠券列表
      - `coupon_id` string, required: 优惠券 ID
      - `coupon_name` string, required: 优惠券名称
      - `coupon_count` integer, required: 优惠券数量
      - `begin_time` integer, required: 开始时间：时间戳（毫秒），UTC, Jan 1, 1970
      - `expire_time` integer, required: 结束时间：时间戳（毫秒），UTC, Jan 1, 1970
      - `coupon_type` 'fixed_discount' | 'discount' | 'threshold' | 'other': 优惠券类型：枚举值
      - `coupon_rate` number, double: 优惠券折扣率：范围为 0 - 1.00 ，9 折即为 0.9 ，95 折即为 0.95 ，以此类推
      - `coupon_threshold` string: 优惠券门槛
      - `cash_back_amount` object: 返还金额
        - `currency` string, required: 原始金额货币类型：3 字母编码，符合 ISO 4217 标准
        - `amount_local` number, double, required: 原始金额
        - `amount_usd` string: 金额（美金）：将原始金额经过汇率换算后的美金金额
        - `amount_cny` string: 金额（人民币）：将原始金额经过汇率换算后的人民币金额
  - `payment_result` object: 支付结果
    - `is_payment_success` 'true' | 'false', required: 支付是否成功：枚举值
    - `payment_message` string: 支付结果描述
    - `is_3ds_used` 'true' | 'false': 是否使用 3DS：枚举值
    - `response_by_3ds` object: 3DS 响应结果
      - `eci_value` string, required: ECI：例如 00、01、02、04、05、06、07
      - `version` string, required: 版本：例如 1.0.2、2.2.0
      - `authentication_type` string, required: 身份验证类型：例如 static、dynamic、oob、decoupled
      - `trans_status` string, required: 3DS transStatus：例如 A、C、D、I、N、R、U、Y
    - `response_by_avs` string: AVS 响应结果
    - `response_by_cvc` string: CVC 响应结果
  - `billing` object: 账单信息
    - `address` object: 账单地址
      - `country` string, required: 国家：两位国家码，符合 ISO 3166 标准
      - `region` string, required: 省 / 州 / 地区
      - `city` string, required: 城市
      - `district` string: 区县
      - `detail` string: 详细地址
      - `zip_code` string: 邮政编码
    - `phone` object: 账单手机号
      - `country_code` string, required: 国家区号：符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
      - `phone_number` string, required: 手机号 / 电话号码：不含 + 号和前缀
    - `email` string: 账单邮箱
    - `recipient` object: 账单收件人
      - `first_name` string: 名
      - `middle_name` string: 中间名
      - `last_name` string: 姓
      - `nickname` string: 昵称
  - `merchant` object: 卖家信息
    - `merchant_id` string, required: 卖家账户 ID
    - `shop_name` string: 店铺名称
    - `shop_phone` object: 店铺电话
      - `country_code` string, required: 国家区号：符合国际电信联盟 E.164 标准，不含 + 号和前缀 0，如 86
      - `phone_number` string, required: 手机号 / 电话号码：不含 + 号和前缀
    - `shop_email` string: 店铺邮箱
    - `shop_address` object: 店铺地址
      - `country` string, required: 国家：两位国家码，符合 ISO 3166 标准
      - `region` string, required: 省 / 州 / 地区
      - `city` string, required: 城市
      - `district` string: 区县
      - `detail` string: 详细地址
      - `zip_code` string: 邮政编码
    - `shop_url` string: 店铺网站地址
    - `register_time` string, required: 卖家注册（创建）时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00
    - `login_time` string: 卖家最近一次登录时间：符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00
    - `merchant_type` 'person' | 'entity': 卖家类型：枚举值
    - `merchant_level` string: 卖家等级
    - `company` string: 卖家公司
    - `primary_category` string: 卖家主营类目
    - `product_count` integer: 卖家在线商品数量
    - `history_order_count` integer: 卖家历史成单量
    - `history_order_amount` 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/anti-fraud-decision-api-cn-ordercreate.md) - [All operations](https://skmtc.dev/trustdecision/apis/anti-fraud-decision-api-cn-ordercreate/llms.txt) - [OpenAPI document](https://skmtc.dev/trustdecision/apis/anti-fraud-decision-api-cn-ordercreate/revisions/6dd13ca74438?raw)