Official Jumio Mobile SDK plugin for Apache Cordova
This plugin is compatible with version 3.9.8 of the Jumio iOS SDK and 3.9.2 of the Jumio Android SDK.
If you have questions, please reach out to your Account Manager or contact Jumio Support.
With this release, we only ensure compatibility with the latest Cordova versions and plugins. At the time of this release, the following minimum versions are supported:
- Cordova: 10.0.0
- Cordova Android: 9.1.0
- Cordova iOS: 6.2.0
Create Cordova project and add our plugin
cordova create MyProject com.my.project "MyProject"
cd MyProject
cordova platform add ios
cordova platform add android
cordova plugin add https://github.com/Jumio/mobile-cordova.git#v3.9.3
Manual integration or dependency management via cocoapods possible, please see the official documentation of the Jumio Mobile SDK for iOS
Add required permissions for the products as described in chapter Permissions
To use the native Jumio Android component, your App needs to support AndroidX. This can be enabled by adding the following preference to your config.xml:
<preference name="AndroidXEnabled" value="true" />
For other build issues, refer to the The FAQ section at the bottom.
To initialize the SDK, perform the following call.
Jumio.initNetverify(<API_TOKEN>, <API_SECRET>, <DATACENTER>, {configuration});
Datacenter can either be US, EU or SG.
Configure the SDK with the configuration-Object.
Configuration | Datatype | Description |
---|---|---|
enableVerification | Boolean | Enable ID verification |
callbackUrl | String | Specify an URL for individual transactions |
enableIdentityVerification | Boolean | Enable face match during the ID verification for a specific transaction |
preselectedCountry | Boolean | Specify the issuing country (ISO 3166-1 alpha-3 country code) |
customerInternalReference | String | Allows you to identify the scan (max. 100 characters) |
reportingCriteria | String | Use this option to identify the scan in your reports (max. 100 characters) |
userReference | String | Set a customer identifier (max. 100 characters) |
sendDebugInfoToJumio | Boolean | Send debug information to Jumio. |
dataExtractionOnMobileOnly | Boolean | Limit data extraction to be done on device only |
cameraPosition | String | Which camera is used by default. Can be FRONT or BACK. |
preselectedDocumentVariant | String | Which types of document variants are available. Can be PAPER or PLASTIC |
documentTypes | String-Array | An array of accepted document types: Available document types: PASSPORT, DRIVER_LICENSE, IDENTITY_CARD, VISA |
enableWatchlistScreening | String | Enables Jumio Screening. Can be ENABLED, DISABLED or DEFAULT (when not specified reverts to DEFAULT) |
watchlistSearchProfile | String | Specifies specific profile of watchlist |
Initialization example with your configuration:
Jumio.initNetverify("API_TOKEN", "API_SECRET", "US", {
requireVerification: false,
userReference: "USERREFERENCE",
preselectedCountry: "USA",
cameraPosition: "BACK",
documentTypes: ["DRIVER_LICENSE", "PASSPORT", "IDENTITY_CARD", "VISA"],
enableWatchlistScreening: "ENABLED",
watchlistSearchProfile: "YOURPROFILENAME"
});
Android eMRTD scanning
If you are using eMRTD scanning, following lines are needed in your Manifest file:
-keep class net.sf.scuba.smartcards.IsoDepCardService {*;}
-keep class org.jmrtd.** { *; }
-keep class net.sf.scuba.** {*;}
-keep class org.bouncycastle.** {*;}
-keep class org.ejbca.** {*;}
-dontwarn java.nio.**
-dontwarn org.codehaus.**
-dontwarn org.ejbca.**
-dontwarn org.bouncycastle.**
Add the needed dependencies following this chapter of the android integration guide.
Enable eMRTD by using the following method in your native android code:
netverifySDK.setEnableEMRTD(true);
As soon as the sdk is initialized, the sdk is started by the following call.
Jumio.startNetverify(successCallback, errorCallback);
Example
Jumio.startNetverify(function(documentData) {
// YOUR CODE
}, function(error) {
// YOUR CODE
});
To initialize the SDK, perform the following call.
Jumio.initDocumentVerification(<API_TOKEN>, <API_SECRET>, <DATACENTER>, {configuration});
Datacenter can either be US, EU or SG.
Configure the SDK with the configuration-Object. (configuration marked with * are mandatory)
Configuration | Datatype | Description |
---|---|---|
type* | String | See the list below |
userReference* | String | Set a customer identifier (max. 100 characters) |
country* | String | Set the country (ISO-3166-1 alpha-3 code) |
customerInternalReference* | String | Allows you to identify the scan (max. 100 characters) |
reportingCriteria | String | Use this option to identify the scan in your reports (max. 100 characters) |
callbackUrl | String | Specify an URL for individual transactions |
documentName | String | Override the document label on the help screen |
customDocumentCode | String | Set your custom document code (set in the merchant backend under "Settings" - "Multi Documents" - "Custom" |
cameraPosition | String | Which camera is used by default. Can be FRONT or BACK. |
enableExtraction | bool | Enable/disable data extraction for documents. |
Possible types:
- BS (Bank statement)
- IC (Insurance card)
- UB (Utility bill, front side)
- CAAP (Cash advance application)
- CRC (Corporate resolution certificate)
- CCS (Credit card statement)
- LAG (Lease agreement)
- LOAP (Loan application)
- MOAP (Mortgage application)
- TR (Tax return)
- VT (Vehicle title)
- VC (Voided check)
- STUC (Student card)
- HCC (Health care card)
- CB (Council bill)
- SENC (Seniors card)
- MEDC (Medicare card)
- BC (Birth certificate)
- WWCC (Working with children check)
- SS (Superannuation statement)
- TAC (Trade association card)
- SEL (School enrollment letter)
- PB (Phone bill)
- USSS (US social security card)
- SSC (Social security card)
- CUSTOM (Custom document type)
Initialization example with configuration.
Jumio.initDocumentVerification("API_TOKEN", "API_SECRET", "US", {
type: "BC",
userReference: "USERREFERENCE",
country: "USA",
customerInternalReference: "YOURSCANREFERENCE",
cameraPosition: "BACK"
});
As soon as the SDK is initialized, the SDK is started by the following call.
Jumio.startDocumentVerification(successCallback, errorCallback);
Example
Jumio.startDocumentVerification(function(documentData) {
// YOUR CODE
}, function(error) {
// YOUR CODE
});
To Initialize the SDK, perform the following call.
Jumio.initBAM(<API_TOKEN>, <API_SECRET>, <DATACENTER>, {configuration});
Datacenter can either be US, EU or SG.
Configure the SDK with the configuration-Object.
Configuration | Datatype | Description |
---|---|---|
cardHolderNameRequired | Boolean | |
sortCodeAndAccountNumberRequired | Boolean | |
expiryRequired | Boolean | |
cvvRequired | Boolean | |
expiryEditable | Boolean | |
cardHolderNameEditable | Boolean | |
merchantReportingCriteria | String | Overwrite your specified reporting criteria to identify each scan attempt in your reports (max. 100 characters) |
vibrationEffectEnabled | Boolean | |
enableFlashOnScanStart | Boolean | |
cardNumberMaskingEnabled | Boolean | |
offlineToken | String | In your Jumio merchant backend on the "Settings" page under "API credentials" you can find your Offline token. In case you use your offline token, you must not set the API token and secret |
cameraPosition | String | Which camera is used by default. Can be FRONT or BACK. |
cardTypes | String-Array | An array of accepted card types. Available card types: VISA, MASTER_CARD, AMERICAN_EXPRESS, CHINA_UNIONPAY, DINERS_CLUB, DISCOVER, JCB |
Initialization example with configuration.
Jumio.initBAM("API_TOKEN", "API_SECRET", "US", {
cardHolderNameRequired: false,
cvvRequired: true,
cameraPosition: "BACK",
cardTypes: ["VISA", "MASTER_CARD"]
});
As soon as the sdk is initialized, the sdk is started by the following call.
Jumio.startBAM(successCallback, errorCallback);
Example
Jumio.startBAM(function(cardInformation) {
// YOUR CODE
}, function(error) {
// YOUR CODE
});
The Netverify SDK can be customized to the respective needs by following this customization chapter.
The Netverify SDK can be customized to the respective needs by following this customization chapter.
The Netverify SDK can be customized to the respective needs by following this customization chapter.
The SDK can be customized to the respective needs. You can pass the following customization options to the initializer:
Customization key | Type | Description |
---|---|---|
disableBlur | BOOL | Deactivate the blur effect |
backgroundColor | STRING | Change base view's background color |
foregroundColor | STRING | Change base view's foreground color |
tintColor | STRING | Change the tint color of the navigation bar |
barTintColor | STRING | Change the bar tint color of the navigation bar |
textTitleColor | STRING | Change the text title color of the navigation bar |
documentSelectionHeaderBackgroundColor | STRING | Change the background color of the document selection header |
documentSelectionHeaderTitleColor | STRING | Change the title color of the document selection header |
documentSelectionHeaderIconColor | STRING | Change the icon color of the document selection header |
documentSelectionButtonBackgroundColor | STRING | Change the background color of the document selection button |
documentSelectionButtonTitleColor | STRING | Change the title color of the document selection button |
documentSelectionButtonIconColor | STRING | Change the icon color of the document selection button |
fallbackButtonBackgroundColor | STRING | Change the background color of the fallback button |
fallbackButtonBorderColor | STRING | Change the border color of the fallback button |
fallbackButtonTitleColor | STRING | Change the title color of the fallback button |
positiveButtonBackgroundColor | STRING | Change the background color of the positive button |
positiveButtonBorderColor | STRING | Change the border color of the positive button |
positiveButtonTitleColor | STRING | Change the title color of the positive button |
negativeButtonBackgroundColor | STRING | Change the background color of the negative button |
negativeButtonBorderColor | STRING | Change the border color of the negative button |
negativeButtonTitleColor | STRING | Change the title color of the negative button |
scanBackgroundColor (NV only) | STRING | Change the background color of the scan overlay |
scanOverlayStandardColor (NV only) | STRING | Change the standard color of the scan overlay |
scanOverlayValidColor (NV only) | STRING | Change the valid color of the scan overlay |
scanOverlayInvalidColor (NV only) | STRING | Change the invalid color of the scan overlay |
scanOverlayTextColor (BAM only) | STRING | Change the text color of the scan overlay |
scanOverlayBorderColor (BAM only) | STRING | Change the border color of the scan overlay |
All colors are provided with a HEX string with the following format: #ff00ff.
Customization example
Jumio.initNetverify("API_TOKEN", "API_SECRET", "US", {
requireVerification: false,
...
}, {
disableBlur: true,
backgroundColor: "#ff00ff",
barTintColor: "#ff1298"
);
To get information about callbacks, Netverify Retrieval API, Netverify Delete API and Global Netverify settings and more, please read our page with server related information.
The JSONObject with all the extracted data that is returned for the specific products is described in the following subchapters:
NetverifyDocumentData
Parameter | Type | Max. length | Description |
---|---|---|---|
selectedCountry | String | 3 | ISO 3166-1 alpha-3 country code as provided or selected |
selectedDocumentType | String | 16 | PASSPORT, DRIVER_LICENSE, IDENTITY_CARD or VISA |
idNumber | String | 100 | Identification number of the document |
personalNumber | String | 14 | Personal number of the document |
issuingDate | Date | Date of issue | |
expiryDate | Date | Date of expiry | |
issuingCountry | String | 3 | Country of issue as (ISO 3166-1 alpha-3) country code |
lastName | String | 100 | Last name of the customer |
firstName | String | 100 | First name of the customer |
dob | Date | Date of birth | |
gender | String | 1 | m, f or x |
originatingCountry | String | 3 | Country of origin as (ISO 3166-1 alpha-3) country code |
addressLine | String | 64 | Street name |
city | String | 64 | City |
subdivision | String | 3 | Last three characters of ISO 3166-2:US state code |
postCode | String | 15 | Postal code |
mrzData | MRZ-DATA | MRZ data, see table below | |
optionalData1 | String | 50 | Optional field of MRZ line 1 |
optionalData2 | String | 50 | Optional field of MRZ line 2 |
placeOfBirth | String | 255 | Place of Birth |
extractionMethod | String | 12 | MRZ, OCR, BARCODE, BARCODE_OCR or NONE |
MRZ-Data
Parameter | Type | Max. length | Description |
---|---|---|---|
format | String | 8 | MRP, TD1, TD2, CNIS, MRVA, MRVB or UNKNOWN |
line1 | String | 50 | MRZ line 1 |
line2 | String | 50 | MRZ line 2 |
line3 | String | 50 | MRZ line 3 |
idNumberValid | BOOL | True if ID number check digit is valid, otherwise false | |
dobValid | BOOL | True if date of birth check digit is valid, otherwise false | |
expiryDateValid | BOOL | True if date of expiry check digit is valid or not available, otherwise false | |
personalNumberValid | BOOL | True if personal number check digit is valid or not available, otherwise false | |
compositeValid | BOOL | True if composite check digit is valid, otherwise false |
BAMCardInformation
Parameter | Type | Max. length | Description |
---|---|---|---|
cardType | String | 16 | VISA, MASTER_CARD, AMERICAN_EXPRESS, CHINA_UNIONPAY, DINERS_CLUB, DISCOVER, JCB or STARBUCKS |
cardNumber | String | 16 | Full credit card number |
cardNumberGrouped | String | 19 | Grouped credit card number |
cardNumberMasked | String | 19 | First 6 and last 4 digits of the grouped credit card number, other digits are masked with "X" |
cardExpiryMonth | String | 2 | Month card expires if enabled and readable |
CardExpiryYear | String | 2 | Year card expires if enabled and readable |
cardExpiryDate | String | 5 | Date card expires in the format MM/yy if enabled and readable |
cardCVV | String | 4 | Entered CVV if enabled |
cardHolderName | String | 100 | Name of the card holder in capital letters if enabled and readable, or as entered if editable |
cardSortCode | String | 8 | Sort code in the format xx-xx-xx or xxxxxx if enabled, available and readable |
cardAccountNumber | String | 8 | Account number if enabled, available and readable |
cardSortCodeValid | BOOL | True if sort code valid, otherwise false | |
cardAccountNumberValid | BOOL | True if account number code valid, otherwise false |
No data returned.
This is a list of common Android build issues and how to resolve them:
-
Gradle plugin 4.X not supported, please install 5.X
--> Change the version in thegradle-wrapper.properties
file -
Device-ready not fired after X seconds
--> The plugin definition in "YOURPROJECT/platforms/android/platform_www/plugins/cordova-plugin-jumio-mobilesdk/www" might be duplicated/corrupted due to the issue mentioned in this Stackoverflow post. Please fix the duplicatedcordova.define()
call in these files as mentioned in the post.
In case there are cocoapods adjustments that need to be made, please refer to your Podfile
under platforms/ios/Podfile
.
In case there are iOS Localization updates that need to be made, please refer to your Localizations
folder under platforms/ios/Pods/JumioMobileSDK/Localizations
after running pod install
.
If iOS application build is failing with ld: framework not found iProov.xcframework
or dyld: Symbol not found: ... Referenced from: /.../Frameworks/iProov.frameworks/iProov
, please make sure the necessary post install-hook has been included in your Podfile
:
post_install do |installer|
installer.pods_project.targets.each do |target|
if ['iProov', 'Socket.IO-Client-Swift', 'Starscream'].include? target.name
target.build_configurations.each do |config|
config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
end
end
end
end
For more information, please refer to our iOS guides.
If you have any questions regarding our implementation guide please contact Jumio Customer Service at [email protected] or https://support.jumio.com. The Jumio online helpdesk contains a wealth of information regarding our service including demo videos, product descriptions, FAQs and other things that may help to get you started with Jumio. Check it out at: https://support.jumio.com.
The software contains third-party open source software. For more information, please see Android licenses and iOS licenses
This software is based in part on the work of the Independent JPEG Group.
© Jumio Corp. 268 Lambert Avenue, Palo Alto, CA 94306