All Products
Search
Document Center

ID Verification:Integration process

Last Updated:Sep 22, 2025

Integrate the client SDK and server-side APIs to perform online user authentication in your existing client application.

Prerequisites

You must understand how to create a request signature to directly call ID Verification service APIs over HTTP or HTTPS. For more information about the signing mechanism, see Integrate with the ID Verification service.

Procedure

  1. Activate the ID Verification service. For more information, see Activate the ID Verification service.

  2. Access Solution

    Integrate the service using the Wireless SDK + Server-side Integration method. The procedure is as follows:

    1. Call the server-side initialization API.

    2. Integrate the client SDK.

    3. Call the server-side query API.

    The following diagram shows the call sequence for the integration steps.Sequence diagram

    Step

    Description

    1

    A user starts a business process, such as an identity proofing process, in the merchant application.

    2

    The merchant app calls the getMetaInfo interface to get metadata from the Alibaba Cloud SDK and the user's device.

    3

    The Alibaba Cloud SDK returns the metadata to the merchant application.

    4

    The merchant application starts a transaction and sends the metadata to the merchant server.

    5

    The merchant server calls the Initialize API with the metadata to get the client configuration. This configuration includes parameters for the SDK connection and behavior.

    6

    The Alibaba Cloud server performs a usability check based on the metadata. If the check passes, the Alibaba Cloud server returns the client configuration to the merchant server.

    7

    The merchant server returns the client configuration to the merchant application.

    8

    The merchant application starts the Alibaba Cloud SDK with the client configuration from Step 7.

    9

    The Alibaba Cloud SDK interacts with the user, captures required data such as face images, and uploads the data to the Alibaba Cloud server for verification. Multiple rounds of interaction between the SDK and the server may occur.

    10

    The Alibaba Cloud server checks the uploaded user data and returns the transaction status to the SDK. If all checks pass, a success code is returned. Otherwise, the process may be interrupted for more user interaction with the SDK.

    11

    The Alibaba Cloud SDK notifies the merchant application that the transaction is complete.

    12

    The merchant application notifies the merchant server that the transaction is complete and starts a double-check of the transaction details.

    13

    The merchant server calls the CheckResult API to double-check the transaction details with the Alibaba Cloud server.

    14

    The Alibaba Cloud server returns the transaction details to the merchant server.

    Note

    To ensure information security, sensitive information, such as the captured face image, is returned only to the merchant server.

    15

    The merchant server filters the transaction details from the Alibaba Cloud server and returns only non-sensitive information to the merchant application.

    16

    The merchant application informs the user that the process is complete.

  3. Integrate the service using one of the following methods.