Introduction

Welcome to the QI Tech Face Recognition SDK integration manual for React Native! The @qitech/react-native-caas module exposes QI Tech's native Android (Java/Kotlin) and iOS (Swift) SDKs through a TypeScript interface. You should use it to run your customer's liveness proof directly from your React Native application and reference the captured image, through a key, in the other products of the QI Tech system.

Available packages

Package	Contents	When to use
@qitech/react-native-caas	Face Recognition, OCR and Device Scan	When you need face recognition, OCR or the full onboarding flow.
@qitech/react-native-device-scan	Device Scan only	When you need only device scan — a lighter installation with fewer native dependencies.

Important Note!

Both packages include Device Scan. Do not install both — choose only one.

For Face Recognition, use @qitech/react-native-caas.

Having issues?

We are not a company that hides behind an API! Contact our support and we will respond as quickly as possible. Feel free to call us if you want a quick response!

We love feedback

Even if you have already solved your problem or if it is very simple (even a typo or poor organization that you already understood), send us an email—this way we make the documentation more and more practical and the next person won't have to suffer the pains you suffered!

Environments

We have two environments for our customers. The selection is made through the CAAS_ENVIRONMENT enum, passed as the first parameter of the startFaceRecon function. At the moment, the following environments are available:

• Production - CAAS_ENVIRONMENT.PRODUCTION
• Sandbox - CAAS_ENVIRONMENT.SANDBOX

Each environment requires a different API key to generate the client_session_key.

Important Note!

Do not use real personal or corporate data in QI Tech's Sandbox environments.

Device Scan integration

The Face Recognition service automatically makes an internal call to Device Scan. Because of that, the success response includes the device_scan_session_id field, which identifies the device scan session performed internally and can be used in an integrated way in other services of the QI Tech ecosystem.

Next steps

1. Compatibility — minimum React Native, iOS and Android versions.
2. Installation — package installation and native Android, iOS and Expo setup.
3. Implementation — obtaining the client_session_key and a complete startFaceRecon example.
4. The FaceReconOptions object — every customization parameter.
5. Collecting the Responses — response structure and error handling.