Authenticate users from your mobile app using the SDK and server-side APIs.
Prerequisites
Understand how to create request signatures for HTTP or HTTPS calls to the ID Verification API. For more information, see Access the ID Verification service.
Procedure
-
Review the App (SDK) and Server-side integration.
-
Call the server-side initialization API.
-
Integrate the client SDK.
-
Call the server-side query API.
Integration flow:

Step
Description
1
The user starts a business process in the merchant app.
2
The app calls the authentication SDK to get MetaInfo.
3
The authentication SDK returns MetaInfo.
4
The app sends an authentication request with MetaInfo to the application server.
5
The application server calls the Initialize API to send an authentication request to the Alibaba Cloud server.
6
The Alibaba Cloud server returns a TransactionId to the application server.
7
The application server passes the TransactionId to the app.
8
The app calls the authentication SDK.
9
The SDK sends user-submitted authentication materials to Alibaba Cloud.
NoteIf safe mode is enabled during the Initialize call, the device token is uploaded to the Singapore site, and a threat tag is returned for use with the authentication result.
10
Alibaba Cloud determines the authentication result based on the submitted materials and returns the result to the SDK.
11
The SDK notifies the app via callback to check the authentication status.
12
The app queries the application server for the authentication status.
13
The application server calls the CheckResult API to query the authentication result from the Alibaba Cloud server.
14
Alibaba Cloud returns the authentication result and materials to the application server.
15
The application server processes the result and passes non-sensitive data to the app.
-
-
Integrate the service with the App (SDK) and Server-side APIs.
-
Call the server-side initialization API: Initialize.
This API returns a TransactionId, a unique identifier that links all API calls in a single authentication request. For more information, seeInitialize.
-
Integrate the SDK into your app. Select a platform:
-
Call the server-side query API: CheckResult.
After authentication completes, call this API from your server to retrieve the result and materials. For more information, seeCheckResult.
-