React Native
Requirements
Installation of the Authenteq Flow npm requires React Native v0.61.5
.
Getting started
Install the required NPM react-native-authenteq-flow
:
$ npm install react-native-authenteq-flow --save
or
$ yarn add react-native-authenteq-flow
Optionally install the Live ID document scanner and its DB with the NPM:
react-native-authenteq-flow-docscanner
react-native-authenteq-flow-docscanner-db
Start an Identification
Import AuthenteqFlow in JS file before usage:
import AuthenteqFlow from 'react-native-authenteq-flow';
Start identification:
To use a token identification or specify a custom theme use identificationWithParameters
specifying a dictionary:
Parameter fields description:
Key name | Type | Description |
| String | Client ID value from Customer Dashboard (required) |
| String | Client Secret value from Customer Daskboard (required unless token is specified) |
| String | In conjunction with Client Secret, Flow ID specify a verification flow defined in customer's dashboard (optional) |
| String | Authentication token (required unless clientSecret is specified) |
| Dictionary | Customized theme settings (optional) |
Android theme property:
Key name | Type | Description |
| String | Android style name (for definition details see Android customization) |
iOS theme properties:
Property name | Type | Description |
| String (hex value) | Main color of your scheme |
| String (hex value) | Text color |
| String (hex value) | Background color for all screens |
| String (hex value) | Color for some highlighted area in screen background |
| String (hex value) | Color for table view cells separator |
| String (hex value) | Color for selected buttons text |
| String (hex value) | Background color for selected buttons |
| String (hex value) | Color for success flow symbols |
| String | Font name for text |
| String | Font name for bold text |
| Image | Custom image for liveness instructions. We recommend using images smaller than 300dp |
| Image | Custom image for passport scan instructions. We recommend using images smaller than 300dp |
| Image | Custom image for driver's license scan instructions. We recommend using images smaller than 300dp |
| Image | Custom image for ID card scan instructions. We recommend using images smaller than 300dp |
| Image | Custom image NFC chip presence verification instructions in the document |
| Image | Custom image NFC document scan instructions |
| Image | Custom image for NFC document inside scan instructions |
| Image | Custom image for proof of address scan instructions. We recommend using images smaller than 300dp |
| Image | Custom icon for ID document. We recommend using images smaller than 250dp |
| Image | Custom icon for proof of address. We recommend using images smaller than 250dp |
Example of identification JSON output for single document (driver's license)
Example of identification JSON output for multiple documents (passport and driver's license)
Deprecated fields
selfieImageFile
is deprecated and is now available as selfieImageFilePath
documentFrontFile
is deprecated and is now available as documentFrontImageFilePath
documentBackFile
is deprecated and is now available as documentBackImageFilePath
Face Authentication
To perform a face authentication, set the parameters for authentication (clientSecret
or token
) and the verificationId
to match:
We suggest to use the token authentication in production environment.
Example of face authentication JSON output
With the code obtained it is possible to get the face authentication result using the following API:
Obtain the result of a face authentication
GET
https://api.app.authenteq.com/mobile-sdk/face-authentication-result
This endpoint is authorized with Basic Authorization. You should use your Client ID
and Client Secret
from the Customer Dashboard as the credentials.
Query Parameters
Name | Type | Description |
---|---|---|
code* | string | The code provided at the conclusion of SDK face authentication |
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Your client credentials combined with a colon separator, base64-encoded and prefixed with "Basic ". |
When successful the response will contain a single boolean property named success
:
Last updated