在入口網站中
KYC 入口網站該呈現的一切,集中在同一處。
客戶入口網站是您的團隊每天工作的地方:不是原始的 API 呼叫紀錄,而是將用量、金鑰、帳務和結果整理成方便人閱讀的樣貌。
方案與訂閱
API 金鑰
用量紀錄
帳務與發票
品牌客製化(適用於符合條件的方案)
Sign-in
依 KYC 入口網站應有的標準嚴密鎖定。
這是您的合規主管會登入的入口網站,因此登入本身所受到的重視,與背後的各項檢查相同。
- 密碼會經過雜湊處理,絕不以明文儲存。
- 連續登入失敗八次,帳號就會鎖定十五分鐘,讓猜測密碼的腳本無從下手。
- 工作階段是一組隨機權杖;伺服器上只保留其雜湊值,且 Cookie 已標示為 HttpOnly。
- 雙重驗證登入 — 即將推出。
- 登入頁面與整個入口網站都提供英文和法文版本。
API 金鑰
可以清楚區分的金鑰,無需開立工單即可撤銷。
金鑰只能從入口網站建立,絕不會透過匿名的 API 呼叫建立,而且每一組金鑰都僅限於您的帳號範圍內。
- Sandbox 金鑰與正式金鑰始終互不相同,因此測試腳本絕不可能意外動到正式環境。
- 完整金鑰只會在建立後立即顯示一次。之後我們只以明文保留簡短的前綴。
- 撤銷金鑰會立即生效:下一個使用該金鑰的請求就會被拒絕。
- 每個金鑰的速率限制是所有方案的一部分。
API 金鑰
範例資料已建立新的 sandbox 金鑰
vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4
請立即複製。此金鑰不會再次顯示,之後只會保留前綴可見。
Sandbox 預設
vk_sand_8Kd9…
Sandbox2026 年 9 月 12 日啟用中正式環境
vk_live_2Qf1…
正式2026 年 8 月 3 日啟用中舊的整合測試
vk_sand_9Ta2…
Sandbox2026 年 2 月 18 日已撤銷
範例資料
結果長什麼樣子。
每次驗證都會以各自獨立、有名稱的判定結果回傳,而不是一個不透明的分數。這是虛構的範例:姓名和證件都是捏造的,但結果的結構是真實的。
Morgan Ellis
California driver's license
- 文件
- 通過
- 證件通過真偽驗證:正面、背面、條碼和 MRZ(若有)皆已讀取。
- 身分
- 通過
- 條碼、MRZ 和印刷頁面上的每個欄位都一致。來源之間不一致時會被標記,絕不會取平均。
- 姓名比對
- 通過
- 您的整合所預期的姓名與證件上的姓名相符。
- 活體偵測
- 通過
- 引導式挑戰,在至少十個影格中追蹤 478 個臉部特徵點。
- Anti-spoof
- 通過
- 不是翻拍照片、螢幕重播或列印出來的臉。
- 深偽
- 通過
- 沒有合成或遭竄改臉部的跡象。
- 面具
- 通過
- 沒有 3D 面具或義體的跡象。
- 竄改
- 已回報
- 針對證件影像的參考性訊號,不是通過/未通過的關卡。
- 人臉比對
- 通過
- 現場人臉與證件肖像相符,並依固定的判定門檻回報。我們絕不顯示百分比。
- 制裁
- Add-on
- 為加購此功能的帳號比對 OFAC、UN、EU、Canada OSFI、UK HMT、Australia DFAT 和 OpenSanctions 名單;名單更新以手動或外部排程同步的方式執行,並非每日自動更新。
- 地址
- 通過
- 若提供了可供比對的地址,則檔案中的地址與證件上印刷或編碼的地址相符。
驗證結果解析
以一筆範例驗證,逐欄位說明。
範例資料:為虛構申請人建立的虛構 session,呈現方式與送達您的儀表板和 webhook 接收端時相同。
- Session ID
- ses_7f2a91c0b3d4 — 建立 session 時取得的 ID,之後所有查詢與 webhook 都使用這個 ID。
- 狀態
- VERIFIED、FAILED、PENDING、IN_PROGRESS 或 EXPIRED。
- 環境
- Sandbox 或正式環境,會標記在 session 上,且絕不混用。
- 申請人
- 姓名、出生日期、證件類型、證件發行國家與司法管轄區,以及地址,皆讀取自身分證件。
- 各項檢查的判定結果
- 證件、活體偵測、防偽造、臉部比對,以及(若已啟用)制裁名單檢查,各自獨立顯示 PASS、FAIL 或 SKIPPED。
- 人臉比對
- 與固定的判定門檻比較。我們只回報通過或未通過,絕不提供百分比。
- 重拍建議
- 發生失敗時,會指出實際需要重拍的是證件還是自拍,而不是籠統地要求再試一次。
- 完成時間
- session 達到最終狀態的時間。
- 傳送方式
- 以簽章的 webhook 傳送至您的 webhook_url,並在儀表板與 API 中提供相同的結果。
此結果所對應的影像會依短時間的計時器自動清除,預設為七天。結果本身則會保留。
完整全貌
管理端、角色與限制,坦白說明。
有兩件事我們想直接說清楚,而不是讓您自己摸索。
管理端
每個客戶入口網站背後,都有一個我們自家團隊使用的獨立內部主控台:一次搜尋即可查看每個帳戶的用量與帳務、變更方案,並在固定且經過測試的範圍內調整共用的偵測設定。它不屬於您的帳戶,您也不會看到它。
角色與限制
目前每個帳戶僅有一組登入。邀請團隊成員並賦予各自角色——管理員、帳務、唯讀——即將推出。每個金鑰的速率限制是所有方案的一部分;正式 API 中的強制執行即將推出,因此請將您方案的限制視為設計時的參考數字,目前 API 尚不會強制攔阻。
建立您的帳戶
在入口網站註冊,並選擇英文或法文。使用 sandbox 不需要信用卡。複製您的 sandbox 金鑰
建立後只會顯示一次。請將它放在環境變數中,不要放進原始碼控管。建立 session
呼叫一次 API,帶入返回 URL 與 webhook URL。再將回傳的連結傳給申請人。讀取結果
可直接在儀表板上查看,或在結果產生的當下,從簽章的 webhook 讀取。
多數團隊在當天下午就能完成可運作的 sandbox 整合。
常見問題