Tovanix
Tovanix

驗證與交易風控使用指南

驗證與交易風控用來核驗你的客戶和他們的交易,按次從帳戶餘額扣費:

  • 六類檢測:個人驗證、企業驗證、交易監測、錢包篩查、名單篩查與註冊風控
  • 在「資料概覽」點「開通」即可使用,開通不收費,沒有月費與最低消費
  • 請求沒有被受理或核實後確認失敗的自動退款;驗證過期或已出結論的不退款
  • 「檢測紀錄」可以篩選、搜尋與匯出,詳情裡有各環節結果與扣費狀態
  • 可以配置結論回呼,或用平台 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

正在載入…