--- title: "风险验证-支付" method: POST path: "/fraud/transaction/v2" --- # 风险验证-支付 `POST /fraud/transaction/v2` ## Request body - object - `channel` string, required — 渠道标识：由 TD 分配 - `session_id` string, required — 会话 ID：会话 ID 是网站服务器为特定用户在访问期间分配的唯一标识，通常可以用 Cookie、表单字段或 URL 的形式存储 - `decision_event` 'order_payment', 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/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)