Tovanix

验证与交易风控 API

用平台 API 密钥从你自己的系统发起个人验证(KYC)、企业验证(KYB)、交易监测与钱包地址筛查,并查询检测记录。开放 API 与控制台是同一条检测流程:单价相同,结论、退款与对账规则也相同。

先在控制台「验证与交易风控」点「开通」,再到「API 管理」创建密钥并勾选「验证与风控」的权限:verification.read 用于查询单价与记录,verification.write 用于发起检测。发起检测按次从账户余额扣费。

接口

GET /api/v1/verification/info：返回本账号是否已开通、四类检测是否开放与单价(美元),以及交易监测与钱包筛查可选的网络与资产。没有开放的类型不给价。
POST /api/v1/verification/checks：发起一次检测,扣费与建记录在同一个请求里完成。身份验证返回交接链接 handoff_url,发给被验证人即可;交易监测与钱包筛查通常直接返回结论。
GET /api/v1/verification/checks：列表按发起时间倒序,支持 kind、status、verdict、keyword(编号 / 地址 / 扣费单号)筛选,page 与 page_size 分页(每页最多 100 条)。单条查询在会话还在被验证人手里时附带 handoff_url。刷新会向服务商重新读取结论(钱包筛查不能刷新,再查一次会重新计费)。

同一个 idempotency_key、同样的内容重试,返回原来那条记录,不再扣费;同一个键换了内容会被拒绝(400)。同一对象编号还没完成的身份验证再次发起,返回原来的会话(reused 为 true),同样不扣费。

结论回调

在控制台「接入设置」填写 https 回调地址并启用。检测记录的状态或结论被异步改变时(身份验证完成、人工复核改判、交易结论更新、失败退款),平台 POST 一条事件。你自己发起的那一下不推送,同步响应里已经有结果。

请求头 X-Tovanix-Event 是事件类型(check.updated 或测试用的 ping),X-Tovanix-Delivery 是 event_id,X-Tovanix-Timestamp 是 Unix 秒,X-Tovanix-Signature 是 sha256= 加上 HMAC-SHA256(签名密钥, 时间戳 + "." + 原始请求体) 的十六进制。

对方返回 2xx 视为送达;其余(包括超时)按 1 分钟、5 分钟、15 分钟、1 小时、3 小时、6 小时、12 小时退避,最多 8 次,之后不再发。重试发的是同一个 event_id 与同一份事件体,请按 event_id 去重。事件可能乱序到达:以 data.updated_at 较新的为准,或收到后调用查询接口取最新状态。停用回调后,还没送达的事件不再发送。

正在加载…