---
title: "风险验证-营销"
method: POST
path: "/fraud/promo/v2"
---

# 风险验证-营销

`POST /fraud/promo/v2`

## Request

- Base URL: `https://cn.apitd.net`
- URL: `https://cn.apitd.net/fraud/promo/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` 'marketing', 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：当账户不存在时可不传
  - `terminal` object, required: 终端信息
    - `black_box` string: 终端设备信息凭证：从 TD 终端安全 SDK 获取
    - `ip` string: 公网 IP 地址：支持 IPV4 和 IPV6
  - `ext` string, json: 扩展信息：与 TD 约定好的扩展信息
  - `event_detail` object, required: 业务事件信息
    - `marketing` object: 营销活动信息
      - `marketing_id` string, required: 活动 ID
      - `open_id` string: 三方身份 ID
      - `open_id_type` string: 三方身份类型：例如 wechat
      - `begin_time` integer: 开始时间：时间戳（毫秒），UTC, Jan 1, 1970
      - `expire_time` integer: 结束时间：时间戳（毫秒），UTC, Jan 1, 1970

## Response `200`

200

- object

## Other responses

- `400`: 400

---

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