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