查询 KYT 结果

每个请求都必须包含通用参数。

查询 KYT 交易检查的处理状态和结构化风险结果。

POST /v1/kyt/query

请求 Body

名称	类型	必填	说明
request_id	String	是	原交易检查使用的同一个 request_id。
order_no	String	否	交易检查返回的订单号。如提供，必须与 request_id 对应的订单一致。

请求示例

{
  "request_id": "kyt-tx-202609100001",
  "order_no": "FEE202609100001"
}

响应 Body

名称	类型	说明
request_id	String	原交易检查使用的请求标识。
order_no	String	本次检查请求对应的 MusePay 订单号。
status	Number	当前订单状态：22 处理中、44 失败、88 关闭或 99 成功。
risk_level	String	筛查服务商返回的风险等级。在分析完成且风险记录可用时返回。
risk_status	String	筛查服务商返回的风险决策。在可用时返回。
result_data	Object	结构化风险指标。在可用时返回。
created_time	Number	风险记录创建时间，为 13 位 Unix 毫秒时间戳。在可用时返回。
updated_time	Number	风险记录更新时间，为 13 位 Unix 毫秒时间戳。在可用时返回。

result_data

名称	类型	说明
source	String	本次检查使用的数据源。
riskScore	Number	数据源返回的风险评分。
riskAmount	Number	识别为风险资金的金额，以 USD 计价。
orderAmtUSDT	Number	交易金额，以 USDT 计价；如有则返回。
riskAmountRatio	Number	识别为风险资金的金额占交易金额的比例。
riskCategoryAmount	Object	各风险类别对应的风险金额。Key 为类别名称，Value 为金额。
riskCategoryAmountPercentage	Object	各风险类别对应的风险金额占比。
riskCategoryLevelAmount	Object	各风险等级对应的风险金额。Key 可能包括 HIGH、MEDIUM 和 LOW。
riskCategoryLevelAmountPercentage	Object	各风险等级对应的风险金额占比。
riskCategoryLevel	Object	各风险类别对应的风险等级。Key 为类别名称，Value 为风险等级。

处理中响应

{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 22
  }
}

已完成响应

{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 99,
    "risk_level": "PASS",
    "risk_status": "APPROVED",
    "result_data": {
      "source": "elliptic",
      "riskScore": 0.0316,
      "riskAmount": 54.10,
      "orderAmtUSDT": null,
      "riskAmountRatio": 0,
      "riskCategoryAmount": {
        "Gambling": 2.05,
        "Dark Service": 2.94
      },
      "riskCategoryAmountPercentage": {},
      "riskCategoryLevelAmount": {
        "HIGH": 50.81,
        "MEDIUM": 3.29
      },
      "riskCategoryLevelAmountPercentage": {},
      "riskCategoryLevel": {
        "Gambling": "MEDIUM",
        "Dark Service": "HIGH"
      }
    },
    "created_time": 1788998400000,
    "updated_time": 1788998401000
  }
}

风险标签和类别由当前配置的筛查服务商提供。请基于实际返回字段实现您的业务策略，不要依赖固定的标签列表。