全部產品
Search
文件中心

ID Verification:接入流程

更新時間:Dec 16, 2025

ID Verification服務提供Web SDK,協助您在瀏覽器或內嵌webview中實現eKYC遠程身分識別驗證功能。本文介紹通過PC或移動端H5網頁接入ID Verification的流程。

接入說明

阿里雲為開發人員提供了多種程式設計語言(Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ 等)的SDK。開發人員只需要整合SDK,通過SDK暴露的方法直接調用ID Verification服務介面。SDK統一封裝了簽名邏輯、逾時機制、重試機制,並根據文檔返回結構化Response對象,易於開發。

說明

如果現有調用SDK的方式無法滿足您的業務情境,您可以通過HTTP、HTTPS原生調用ID Verification服務介面。由於構建自訂請求涉及到請求的簽名機制,阿里雲SDK已經實現了該機制的演算法,具體內容,請參見接入ID Verification服務

操作步驟

  1. 開通ID Verification服務。具體操作,請參見開通ID Verification服務

  2. 接入PC或移動端H5網頁認證方案。

  • 調用服務端初始化介面,擷取認證URL。具體步驟,請參見Initialize

  • 在應用用戶端接入認證URL。具體步驟,請參見跳轉頁面接入

  • 調用服務端查詢介面CheckResult

    當完成認證時,可以在服務端通過調用該介面擷取相應的認證狀態和認證資料,詳情請參見CheckResult

可以查看下方調用時序圖瞭解詳細接入步驟。

image

序號

說明

1

使用者通過商家H5網頁發起商務程序。

2

H5頁面調用認證SDK擷取MetaInfo。

3

認證SDK返回MetaInfo。

4

H5頁面嚮應用服務端發起認證請求並傳遞MetaInfo。

5

應用服務端向阿里雲服務端調用發起認證請求介面Initialize

6

阿里雲服務端返回TransactionUrl和Protocol(iframe整合時可選)給應用服務端。

7

應用服務端將TransactionUrl傳遞給H5頁面

8

H5頁面調用認證SDK。

9

認證SDK將使用者提交的認證資料傳遞給阿里雲服務端。

說明

Initialize初始化環節開啟安全模式,此時會將裝置Token上傳至新加坡網站,並返迴風險標籤用於認證結果消費。

10

阿里雲服務端根據資料判定認證結果,並將認證結果返回給SDK。

11

SDK通過回呼函數指引H5頁面擷取認證狀態。

12

H5頁面嚮應用服務端查詢認證狀態。

13

應用服務端向阿里雲服務端調用查詢認證結果介面CheckResult

14

阿里雲服務端將認證結果及相關認證資料返回給應用服務端。

15

應用服務端對擷取到的認證資訊進行處理,將非敏感資訊傳遞給H5頁面