交易检查

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

提交链上交易进行异步 KYT 风险筛查。

POST /v1/kyt/transaction-check

请求 Body

名称	类型	必填	说明
request_id	String	是	合作伙伴账户内唯一的请求标识。仅在重试同一次检查请求时复用。
chain	String	是	区块链网络标识，例如 TRX。
currency	String	是	指定网络上的资产标识，例如 USDT。
txn_hash	String	是	交易哈希。长度必须为 8–128 个字符，只能包含字母、数字、下划线或连字符。
destination_address	String	否	交易目标地址。如提供，必须是有效的区块链地址。

请求示例

{
  "request_id": "kyt-tx-202609100001",
  "chain": "TRX",
  "currency": "USDT",
  "txn_hash": "97a17b73d21d7bcc476d6053e7044b21948c49fd65d10f78d38c4536229c80a6",
  "destination_address": "TELGzjHK7bpMN6fHwkvZbVkraDf3C9uTFG"
}

响应 Body

名称	类型	说明
request_id	String	合作伙伴提供的请求标识。
order_no	String	本次检查请求对应的 MusePay 订单号，请保存并用于后续结果查询。
status	Number	当前订单状态。首次响应通常为 22（处理中）。
risk_level	String	筛查服务商返回的风险等级。相同 request_id 命中已完成的缓存结果时返回。
hit	Boolean	是否命中一个或多个风险规则。随已完成结果返回。
hit_rules	Array	该交易命中的风险规则。随已完成结果返回。
actions	Array	风险引擎生成的动作。随已完成结果返回。
result_data	Object	结构化风险指标。结构与 result_data 相同，在可用时返回。

hit_rules

名称	类型	说明
rule_code	String	命中的风险规则代码。
decision_code	String	规则生成的决策代码。
salience	Number	规则优先级或显著性。
result_data	Object	与命中规则相关的服务商数据。

actions

名称	类型	说明
action_code	String	风险引擎生成的动作代码。
carry_param	String	动作携带的附加参数（如有）。

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

请轮询查询 KYT 结果，直到状态变为 99（成功）、44（失败）或 88（关闭）。