全部产品
Search
文档中心

ID Verification:接入流程

更新时间:Dec 15, 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页面