shareid_onboarding_sdk 1.3.4
shareid_onboarding_sdk: ^1.3.4 copied to clipboard
The ShareID SDKs are built in design to offer the best user experience.
Table of contents #
Overview #
This SDK provides a drop-in set of screens and tools for Android applications with Flutter to allow capturing of identity documents and face videos for the purpose of identity verification. The SDK offers a number of benefits to help you create the best onboarding/identity verification experience for your customers:
- Carefully designed UI to guide your customers through the entire video-capturing process
- Modular design to help you seamlessly integrate the video-capturing process into your application flow
- Advanced image quality detection technology to ensure the quality of the captured images meets the requirement of the ShareId identity verification process, guaranteeing the best success rate
- Direct video upload to the ShareId service, to simplify integration*
* Note: the SDK is only responsible for capturing and uploading videos. You still need to access the ShareID API to create and manage checks.
Getting started #
The Flutter SDK supports:
Dart 3.0.0 or higher
Flutter 3.0.0 or higher
Android API level 21+
Kotlin 1.8.0 or higher
IOS 15.0 or higher
Targeted Device Families = iPhone, iPad
1. Obtaining a Business Request Id #
In order to start integration, you will need the Business Request Id and Business Request Secret. (waring not finished need link to side where customer may create Business Request Id
2. Creating an applicant #
You must create an SDK applicant before you start the flow.
You must create applicants on your server. For a document or face check, the minimum applicant details required are first_name
and last_name
:
3. Configuring Business Request Id and Business Request Token #
We now support one token mechanism:
Server Url
,
Business Request Id
,
Business Request Token
,
Callback Url
,
4. App permissions #
For IOS
The SDK uses the device camera functionality. It is mandatory to include the following key NSCameraUsageDescription within your application's Info.plist file (see Apple documentation).
4. Set up the SDK in your application #
Once you have added the SDK as a dependency and have your credentials, you can configure the SDK :
final _shareid = ShareidOnboarding();
_shareid.signUp("serverUrl","accessToken", "callbackUrl", "externalId").then((value) {
setState(() {
Map<String, dynamic> valueMap = json.decode(value!);
result = ResultService.fromJson(valueMap);
});
});
For more informations : Example File
Parameter | Notes |
---|---|
serverUrl |
required Your server url (sandbox,preprod or prod) |
accessToken |
required Your previously received access token |
callbackUrl |
required Your callback url |
externalId |
optional Your external identifier |
applicationId |
required only for authenticate The identifier that ShareID provided after the user was integrated via the identity verification request |
5.Handling Callback #
The result object passed to the callback function can include the following attributes:
{
"code": "200",
"message": "Access token created",
"external_id": "Your external id",
"uuid": "Your User Unique Identifier"
}