验证与交易风控使用指南
验证与交易风控用来核验你的客户和他们的交易,按次从账户余额扣费:
- 六类检测:个人验证、企业验证、交易监测、钱包筛查、名单筛查与注册风控
- 在「数据概览」点「开通」即可使用,开通不收费,没有月费与最低消费
- 请求没有被受理或核实后确认失败的自动退款;验证过期或已出结论的不退款
- 「检测记录」可以筛选、搜索与导出,详情里有各环节结果与扣费状态
- 可以配置结论回调,或用平台 API 密钥从自己的系统发起检测
这个业务能做什么
验证与交易风控用来核验你的客户和他们的交易:给个人或企业做身份验证,在转账前后评估交易风险,筛查钱包地址和名单,以及在客户注册时评估邮箱、手机号或 IP 的风险。
- 个人验证 — 被验证人用手机完成证件拍摄、活体检测与人脸比对。
- 企业验证 — 核查企业登记、企业文件与关键人员。
- 交易监测 — 分法币交易与加密交易,评估一笔交易的风险;加密交易同时筛查链上地址。
- 钱包筛查 — 单独筛查一个钱包地址的风险,以及是否命中制裁名单。
- 名单筛查 — 按姓名或公司名筛查 PEP、制裁与监管警示名单,当场出结论。
- 注册风控 — 评估邮箱、手机号或 IP 的风险,例如一次性邮箱、虚拟号码、VPN 与机房 IP。
结论只作参考,平台不会据此自动冻结或拒绝任何资金。平台只保存各环节的结论、分数与命中情况,不保存姓名、证件号和证件影像。这个业务没有测试环境,每一次检测都是真实检测、真实扣费。
开通
在「验证与交易风控 → 数据概览」点「开通」即可。开通不收费,也不需要填写任何账号或密钥。开通卡片上列出了各类检测的单价,标着「暂未开放」的类型暂时不能使用。
- 开通后,可以在「接入设置」里按需设置交接页、结论回调和开放 API,见下文。
- 每次检测都从账户余额扣费,发起前请确认余额充足。
计费与退款
按次从账户余额扣费,没有月费,也没有最低消费。单价在「数据概览」的入口卡片、发起页面和扣费确认框里都能看到,以页面显示为准;交易监测分法币和加密两档,注册风控按邮箱、手机号、IP 分别计价。
- 这次请求没有被受理 — 自动退款,记录显示「失败」。
- 记录显示「结果核实中」 — 系统会自动核实,确认失败的自动退款。
- 被验证人没有完成、验证已过期 — 不退款。
- 已出结论(包括「拒绝」「复核中」「未评估」) — 不退款。
- 同一个对象编号还有没完成的验证时再次发起 — 不重复扣费,直接打开原来那次验证。
企业验证分两步结算:发起时按页面写明的最终受益人人数预扣,出结论后按实际人数与企业注册地结算,多退少补;记录详情里有计费明细。
发起个人或企业验证
- 填写对象编号: 在「验证与交易风控 → 身份验证 → 个人验证」或「企业验证」里,填写你业务系统中这个对象的唯一编号,也可以点「从目录选择」。编号只能包含字母、数字和 . _ : @ + -,长度 1 到 128,并以字母或数字开头。
- 确认扣费: 点「发起验证」,在确认框里核对检测类型与单价,再点「确认并扣费」。
- 把链接交给被验证人: 页面会给出验证链接和二维码,可以「复制链接」发给被验证人,或者让他「用手机扫码打开」。链接只用于这一次验证,完成或过期后失效。
- 等待结论: 被验证人先阅读并同意告知,再用手机完成采集。页面按「已创建」「已同意告知」「验证中」「出结论」显示进度,并自动刷新。
被验证人打开链接后,最先看到的是交接页:谁邀请他验证、要阅读并同意哪些文件。在「接入设置」的「交接页」里,可以设置页面上的请求方名称(最多 60 个字符),以及你自己的隐私政策和服务条款链接(两个链接要一起填,必须是 https);之后拍摄证件与自拍的页面样式由平台统一。
交易风控
「验证与交易风控 → 交易风控」有五个页签。填好内容后点「开始检测」,页面会给出检测报告:风险分、结论和触发的规则。
- 法币交易 — 交易主体的编号与姓名、方向(入账或出账)、金额与币种。主体姓名只用于筛查,平台不保存明文。
- 加密交易 — 交易主体、方向、网络与资产、金额和对手方地址;已上链的入账可以填交易哈希和本方收款地址。网络支持 TRON、Ethereum、BNB Chain、Polygon、Solana、Bitcoin。
- 钱包地址 — 网络与钱包地址,单独筛查这个地址的风险与制裁名单命中。
- 名单筛查 — 个人或公司,以及姓名或公司名称;生日与国籍可选,填写能减少同名误报。平台不保存这个名字。
- 注册风控 — 邮箱、手机号或 IP 地址三选一。可以填你给这个客户的编号,同一个邮箱或号码出现在你名下别的客户上时会提示;记录里只保留脱敏后的值。
钱包筛查、名单筛查和注册风控当场出结论,再查一次会重新扣费。名单筛查和注册风控的「需复核」表示可能命中名单或有风险信号,结论不会再变,需要你结合业务自行判断。
看结果与检测记录
「检测记录」列出全部检测,可以按类型、状态、结论筛选,按编号、地址或扣费单号搜索,并按当前筛选「导出」CSV(最多 5000 条)。点开一条记录,可以看到各环节结果、风险分、扣费单号和扣费状态。「目录」下的「用户」「企业」按对象编号汇总你发起过的验证。
- 已受理 / 等待被验证人 / 处理中 — 检测还在进行中。
- 结果核实中 — 结果不明确,系统正在核实,确认失败会自动退款。
- 失败 — 检测没有完成,费用已退回。
- 通过 / 拒绝 / 复核中 — 检测结论。「复核中」表示正在人工复核,结论可能变化,完成后自动更新。
- 未评估 — 没有这个对象的可用数据,未给出风险判断,这不代表安全。
- 已过期 — 被验证人没有在有效期内完成验证。
- 退款在三处可以看到:检测记录的「费用」列标「已退」,详情里「扣费状态」为「已退款」,「财务管理」的账单里有对应的退款记录。
- 「数据概览」的本月检测与本月花费按 UTC 自然月统计,不含已退款的检测。
- 个人验证、企业验证和交易监测可以在记录详情里刷新结果,刷新不扣费。
结论回调与开放 API
- 在「接入设置」的「结论回调」里填写 https 回调地址并启用。检测记录的状态或结论变化时,平台向这个地址 POST 一条签名事件;对方没有返回 2xx 时按退避重试,最多 8 次。
- 签名密钥只在生成时显示一次。用它校验请求头 X-Tovanix-Signature:值是 sha256= 加上 HMAC-SHA256(签名密钥, 时间戳 + "." + 原始请求体) 的十六进制,时间戳在 X-Tovanix-Timestamp 里。点「重新生成密钥」后旧密钥立即失效。
- 可以点「发送测试事件」检查连通,「最近投递」里能看到每次投递的结果。
- 开放 API:在「我的账户 → API 管理」创建密钥时勾选「验证与风控」权限,就能从你自己的系统发起检测、查询记录。单价与控制台相同,发起检测时必须带幂等键。
常见问题排查
- 发起时提示余额不足 — 账户余额不够这次检测的单价 — 这次没有扣费,充值后重试。
- 发起时提示验证服务拒绝了本次请求 — 这次请求没有被受理 — 费用会自动退回,检测记录的「费用」列会标「已退」。检查填写的内容后重新发起。
- 记录一直显示「结果核实中」 — 结果不明确,系统正在反复核实 — 等待自动核实;长时间不变的,联系客服并附上记录编号。
- 被验证人打开链接后看到「验证链接不可用」 — 链接已过期,或这次验证已经结束 — 重新发起一次验证并发送新链接,重新发起会再次扣费。
- 回调验签失败 — 没有用原始请求体计算签名,或签名密钥已重新生成 — 用收到的原始请求体计算签名,不要先解析再序列化;重新生成密钥后,同步更新你系统里的密钥。
常见问题
验证过期或结论为拒绝,费用会退吗?
不会。检测在发起时扣费,被验证人没有完成、验证过期或结论为拒绝都不退款;只有这次请求没有被受理,或者核实后确认失败,才会自动退款。
结论是「拒绝」,平台会冻结资金吗?
不会。结论只作参考,平台不会据此自动冻结或拒绝任何资金,是否放行由你自己决定。
能用 API 接入吗?
能。在「我的账户 → API 管理」创建密钥并勾选「验证与风控」权限即可;结论回调在「接入设置」里配置。
相关页面: 帮助中心 · 使用指南与常见问题 · 验证与交易风控 · 验证与交易风控 API
正在加载…