Alipay Mini Program integration

Updated at:

The financial-grade real-person authentication solution combines liveness detection, biometric recognition, and identity verification APIs from authoritative sources to verify the user. This topic describes how to integrate the service with an Alipay Mini Program.

Important

The Alipay Mini Program integration method does not support storing face images. If you need to store these images, use App (SDK) integration or H5 webpage access.

Limitations

The Financial-grade Real-Person Verification solution currently verifies only residents who hold one of the following ID documents:

  • Chinese mainland residents: Second-generation Resident ID Card.

  • Hong Kong and Macao SAR residents: Residence Permit for Hong Kong and Macao Residents.

  • Taiwan residents: Residence Permit for Taiwan Residents.

Important
  • Exception handling

    Changes to the authoritative data source may cause authentication to fail for some users because their identity information cannot be retrieved. Include a manual review option in your business flow as a fallback mechanism.

  • Supported permanent residence and travel permits

    To authenticate the following certificates, use the solution in Alipay H5 page integration or Alipay Mini Program integration. No other solutions are supported.

    • Foreign Permanent Resident ID Card

    • Mainland Travel Permits for Hong Kong and Macao Residents

    • Mainland Travel Permit for Taiwan Residents

  • Unsupported certificates

    • Exit-Entry Permit for Travelling to and from Taiwan

    • Exit-Entry Permit for Travelling to and from Hong Kong and Macao

    • Foreigner's Exit-Entry Permit

Billing

You are charged based on the number of successful calls. For more information, see Billing overview.

Integration method

Alipay Mini Program integration is applicable when you want to perform online authentication for users in an Alipay Mini Program that you developed. The Alipay Mini Program integration method is described as follows.

Product code

Integration method

User verification flow

Inputs

Primary output

Output details

FACE

Alipay Mini Program + server-side access

liveness detection

Name and ID card number

Verification result

Query verification results

Verification flow

The service captures the user's face, performs liveness detection, and uses face comparison against an authoritative database to verify the user. For detailed steps, see the integration process.

The user flow for the financial-grade real-person authentication service in an Alipay Mini Program consists of three steps. First, on the identity verification page, you review the authorization details and click Agree to Terms and Authenticate. Second, after you confirm your identity information, you click Scan Face to go to the face capture page. Third, you follow the on-screen prompts to complete liveness detection actions, such as "Pick up your phone and blink", and the system automatically completes the face comparison and verification.