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
For iOS setup check here. For Android setup check here.
Start an Identification
Import AuthenteqFlow in JS file before usage:
import AuthenteqFlow from 'react-native-authenteq-flow';
Start identification:
1
AuthenteqFlow
2
  .identification("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
3
  .then((res) => {
4
    console.log(res);
5
  }).catch((error) => {
6
    console.error(error);
7
  })
Copied!
To use a token identification or specify a custom theme use identificationWithParameters specifying a dictionary:
1
AuthenteqFlow
2
  .identificationWithParameters({
3
     clientId: "YOUR_CLIENT_ID", 
4
     clientSecret: "YOUR_CLIENT_SECRET", 
5
     theme: {
6
        // iOS or Android custom theme 
7
     }
8
  })
9
  .then((res) => {
10
    console.log(res);
11
  }).catch((error) => {
12
    console.error(error);
13
  })
Copied!
Parameters description:
Key name
Type
Description
clientId
String
Client ID value from Customer Dashboard (required)
clientSecret
String
Client Secret value from Customer Daskboard  (required unless token is specified)
flowId
String
In conjunction with Client Secret, Flow ID specify a verification flow defined in  customer's dashboard (optional)
token
String
Background color for all screens  (required unless clientSecret is specified)
theme
Dictionary
Customized theme settings  (optional)
 Android theme property:
Key name
Type
Description
AndroidStyle
String
Android style name (for definition details see Android customization)
iOS theme properties:
Property name
Type
Description
primaryColor
String (hex value)
Main color of your scheme
textColor
String (hex value)
Text color
screenBackgroundColor
String (hex value)
Background color for all screens
viewBackgroundHighlightColor
String (hex value)
Color for some highlighted area in screen background
separatorColor
String (hex value)
Color for table view cells separator 
selectedButtonTextColor
String (hex value)
Color for selected buttons text
selectedButtonBackgroundColor
String (hex value)
Background color for selected buttons
successColor
String (hex value)
Color for success flow symbols
font
String
Font name for text
boldFont
String
Font name for bold text

identificationInstructionImageForSelfie
Image
Custom image for liveness instructions. We recommend using images smaller than 300dp
identificationInstructionImageForPassport
Image
Custom image for passport scan instructions. We recommend using images smaller than 300dp
identificationInstructionImageForDriverLicense
Image
Custom image for driver's license scan instructions. We recommend using images smaller than 300dp
identificationInstructionImageForIdCard
Image
Custom image for ID card scan instructions. We recommend using images smaller than 300dp
identificationNfcSymbolCheck
Image
Custom image NFC chip presence verification instructions in the document
identificationNfcInstruction
Image
Custom image NFC document scan instructions
identificationNfcScanInside
Image
Custom image for NFC document inside scan instructions
identificationInstructionImageForProofOfAddress
Image
Custom image for proof of address scan instructions. We recommend using images smaller than 300dp
identificationIconForIdDocument
Image
Custom icon for ID document. We recommend using images smaller than 250dp
Example of identification JSON output for single document (driver's license)
1
{
2
    "verificationId": "3EF7784D-CBBB-4737-98F9-322E895EC667",
3
    "selfieImageFilePath": "path/to/jpeg_file",
4
    "proofOfAddressFilePath": "path/to/document_file",
5
    "documents": [
6
        {
7
            "dateOfBirth": "1987-01-12",
8
            "dateOfExpiry": "2045-05-22",
9
            "dateOfIssue": "2015-05-22",
10
            "documentFrontImageFilePath": "path/to/jpeg_file",
11
            "documentBackImageFilePath": "path/to/jpeg_file",
12
            "documentNumber": "DXY191672",
13
            "documentType": "DL",
14
            "givenNames": "ANNA MARIA",
15
            "surname": "SCHMIDT",
16
            "surnameAndGivenNames": "SCHMIDT ANNA MARIA",
17
            "address": "2345 ANYPLACE AVE ANYTOWN NY 12345",
18
            "isEighteenPlus": true,
19
            "isSixteenPlus": true,
20
            "issuingCountry": "DEU",
21
            "isTwentyOnePlus": true,
22
            "licenseClass": "A1 A B1 B",
23
            "licenseClassDetails": {
24
                "A": {
25
                    "from": "2015-05-22"
26
                },
27
                "A1": {
28
                    "from": "2015-05-22"
29
                },
30
                "B": {
31
                    "from": "2004-08-27"
32
                },
33
                "B1": {
34
                    "from": "2004-08-27"
35
                }
36
            }
37
        }
38
    ]
39
}
Copied!
Example of identification JSON output for multiple documents (passport and driver's license)
1
{
2
    "verificationId": "3EF7784D-CBBB-4737-98F9-322E895EC667",
3
    "selfieImageFilePath": "path/to/jpeg_file",
4
    "proofOfAddressFilePath": "path/to/document_file",
5
    "documents": [
6
        {
7
            "dateOfBirth": "1987-01-12",
8
            "placeOfBirth": "BERLIN",
9
            "dateOfExpiry": "2027-01-30",
10
            "documentFrontImageFilePath": "path/to/jpg_file",
11
            "documentNumber": "8136431812",
12
            "personalNumber": "123456",
13
            "documentType": "PP",
14
            "givenNames": "ANNA MARIA",
15
            "surname": "SCHMIDT",
16
            "surnameAndGivenNames": "SCHMIDT ANNA MARIA",
17
            "address": "2345 ANYPLACE AVE ANYTOWN NY 12345",
18
            "isEighteenPlus": true,
19
            "isSixteenPlus": true,
20
            "issuingCountry": "DEU",
21
            "issuingAuthority": "FOREIGN OFFICE",
22
            "isTwentyOnePlus": true,
23
            "nationality": "DEU",
24
            "sex": "F"
25
        },
26
        {
27
            "dateOfBirth": "1987-01-12",
28
            "dateOfExpiry": "2045-05-22",
29
            "dateOfIssue": "2015-05-22",
30
            "documentFrontImageFilePath": "path/to/jpeg_file",
31
            "documentBackImageFilePath": "path/to/jpeg_file",
32
            "documentNumber": "DXY191672",
33
            "documentType": "DL",
34
            "givenNames": "ANNA MARIA",
35
            "surname": "SCHMIDT",
36
            "surnameAndGivenNames": "SCHMIDT ANNA MARIA",
37
            "address": "2345 ANYPLACE AVE ANYTOWN NY 12345",
38
            "isEighteenPlus": true,
39
            "isSixteenPlus": true,
40
            "issuingCountry": "DEU",
41
            "isTwentyOnePlus": true,
42
            "licenseClass": "A1 A B1 B",
43
            "licenseClassDetails": {
44
                "A": {
45
                    "from": "2015-05-22"
46
                },
47
                "A1": {
48
                    "from": "2015-05-22"
49
                },
50
                "B": {
51
                    "from": "2004-08-27"
52
                },
53
                "B1": {
54
                    "from": "2004-08-27"
55
                }
56
            }
57
        }
58
    ]
59
}
Copied!
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:
1
AuthenteqFlow
2
  .faceAuthenticationWithParameters({
3
     clientId: "YOUR_CLIENT_ID", 
4
     clientSecret: "YOUR_CLIENT_SECRET", 
5
     verificationId: "VERIFICATION ID TO MATCH",
6
     theme: {
7
        // iOS or Android custom theme 
8
     }
9
  })
10
  .then((res) => {
11
    console.log(res);
12
  }).catch((error) => {
13
    console.error(error);
14
  })
Copied!
We suggest to use the token authentication in production environment.
Example of face authentication JSON output
1
{
2
    "code": "xy4q6o"
3
}
Copied!
With the code obtained it is possible to get the face authentication result using the following API:
get
https://api.app.authenteq.com
/mobile-sdk/face-authentication-result
Obtain the result of a face authentication
When successful the response will contain a single boolean property named success:
1
{
2
    "success": true
3
}
Copied!
Customization
iOS
Last modified 16d ago
Copy link
Contents
Requirements
Getting started
Start an Identification
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
Face Authentication
get
Obtain the result of a face authentication