喺入口網站內
KYC 入口網站應有嘅一切,盡在一處。
客戶入口網站係你團隊日常工作嘅地方:唔係 API 呼叫嘅原始紀錄,而係將用量、金鑰、帳單同結果整理成方便閱讀嘅版面。
方案及訂閱
API 金鑰
用量紀錄
帳單及發票
品牌設定(適用於符合資格嘅方案)
Sign-in
按 KYC 入口網站應有嘅標準嚴格鎖定。
呢個係你嘅合規主管會登入嘅入口網站,所以登入本身同背後嘅查核一樣受到嚴謹對待。
- 密碼經過雜湊處理,絕不以純文字儲存。
- 連續八次登入失敗會鎖定帳戶十五分鐘,令猜密碼嘅程式無從入手。
- 工作階段係一個隨機權杖;伺服器只保存其雜湊值,而 cookie 已標記為 HttpOnly。
- 雙重驗證登入 — 即將推出。
- 登入頁面同整個入口網站都有英文同法文版本。
API 金鑰
易於分辨,無需開工單就可撤銷嘅金鑰。
金鑰只可以由入口網站建立,絕不會透過匿名 API 呼叫建立,而且每條都只限於你嘅帳戶使用。
- Sandbox 金鑰同正式金鑰始終分開,所以測試腳本絕對唔會誤觸正式環境。
- 完整金鑰會喺你建立後即時顯示一次。之後我哋只會以明文保留短前綴。
- 撤銷金鑰即時生效:之後用佢發出嘅下一個請求會被拒絕。
- 每個方案都設有按 key 計算嘅速率限制。
API 金鑰
範例資料已建立新的 sandbox 金鑰
vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4
請即時複製。此金鑰不會再次顯示,之後只會保留前綴可見。
Sandbox 預設
vk_sand_8Kd9…
Sandbox2026年9月12日使用中正式環境
vk_live_2Qf1…
正式2026年8月3日使用中舊有整合測試
vk_sand_9Ta2…
Sandbox2026年2月18日已撤銷
範例資料
結果係咩樣。
每次驗證都會以獨立、有名稱嘅判定結果返回,而唔係一個不透明嘅分數。呢個係虛構樣本:姓名同證件都係杜撰,但結果嘅格式係真實嘅。
Jordan Reyes
Ontario driver's licence
- 證件
- 通過
- 證件通過真偽驗證:正面、背面、條碼同 MRZ(如有)全部讀取成功。
- 身份
- 通過
- 條碼、MRZ 同印刷頁面喺每個欄位上都一致。如有來源出現分歧,會被標記,絕不會取平均值。
- 姓名相符
- 通過
- 你嘅整合預期嘅姓名同證件上嘅姓名相符。
- 活體檢測
- 通過
- 引導式挑戰,喺至少十格畫面中追蹤 478 個面部特徵點。
- Anti-spoof
- 通過
- 唔係相片翻拍、螢幕重播或者列印出嚟嘅面孔。
- 深偽
- 通過
- 冇發現合成或者被竄改嘅面孔跡象。
- 面具
- 通過
- 冇發現 3D 面具或者義體嘅跡象。
- 篡改
- 已回報
- 針對證件圖像嘅參考訊號,並非通過/不通過嘅關卡。
- 人臉比對
- 通過
- 真人面孔同證件肖像相符,並對照固定嘅判定線報告。我哋從不顯示百分比。
- 制裁
- Add-on
- 為已加入此功能嘅帳戶篩查 OFAC、UN、EU、Canada OSFI、UK HMT、Australia DFAT 同 OpenSanctions 名單;名單更新以手動或外部排程同步方式執行,並非自動每日更新。
- 地址
- 通過
- 當有提供地址作比對時,存檔地址同證件上印刷或編碼嘅地址相符。
結果剖析
逐個欄位解說一個範例驗證。
範例資料:為虛構申請人而建立嘅虛構工作階段,以送達你嘅儀表板同 webhook 接收端嘅形式展示。
- 工作階段 ID
- ses_7f2a91c0b3d4 ——你建立工作階段時所用嘅 id,之後每次查詢同 webhook 都會用佢。
- 狀態
- VERIFIED、FAILED、PENDING、IN_PROGRESS 或 EXPIRED。
- 環境
- Sandbox 或正式環境,會標記喺工作階段上,絕對唔會混淆。
- 申請人
- 姓名、出生日期、證件類型、證件簽發國家及司法管轄區,以及地址,均讀取自身份證件。
- 逐項檢查結果
- 證件、活體偵測、防偽冒、人臉比對,以及(如已啟用)制裁名單篩查,每項各自顯示 PASS、FAIL 或 SKIPPED。
- 人臉比對
- 同固定嘅判定標準比較。我哋只報告通過或不通過,絕不顯示百分比。
- 重拍建議
- 如果失敗,會指出究竟係證件定自拍需要重新拍攝,而唔係籠統地叫你再試一次。
- 完成時間
- 工作階段達到最終狀態嘅時間。
- 傳送方式
- 會向你嘅 webhook_url 發送已簽署嘅 webhook,而同一份結果亦會喺儀表板同 API 中提供。
此結果背後嘅影像會按短時間自動清除,預設為七日。結果本身會保留。
其餘部分
如實講解管理端、角色同限制。
有兩件事值得直接講清楚,免得你自己慢慢發現。
管理端
每個客戶入口背後,都有一個我哋自己團隊使用嘅獨立內部控制台:一次搜尋即可睇到所有帳戶嘅用量同帳單、方案變更,以及喺固定並經測試嘅範圍內調校嘅共用偵測設定。呢個控制台並非你帳戶嘅一部分,你亦睇唔到。
角色同限制
現時每個帳戶只有一個登入。邀請隊友並指派各自角色——管理員、帳單、唯讀——即將推出。每個方案都設有按 key 計算嘅速率限制;正式 API 嘅執行機制即將推出,所以請將你方案嘅限制視為設計時嘅參考數字,而唔係 API 已經強制執行嘅上限。
建立你嘅帳戶
喺入口註冊,並揀選英文或法文。使用 sandbox 毋須提供信用卡。複製你嘅 sandbox key
建立後只會顯示一次。請放入你嘅環境變數,唔好放入原始碼管理。建立工作階段
一次 API 呼叫,附上返回 URL 同 webhook URL。然後將傳回嘅連結發送俾申請人。讀取結果
可以喺儀表板睇住結果送到,或者結果一出就由已簽署嘅 webhook 讀取。
大多數團隊都可以在同一個下午完成可運作的 sandbox 整合。
問題