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 較新的為準,或收到後呼叫查詢介面取得最新狀態。停用回呼後,尚未送達的事件不再傳送。

正在載入…