mt-id-verification-sdk
v0.1.2
Published
SDK for embedding an iframe for ID verification. IDNow, OnFido or whatever
Downloads
7
Maintainers
Readme
Moneytrans. ID Verification SDK
SDK for embedding an iframe for ID verification.
Installation
You can install the SDK from npm:
npm install mt-id-verification-sdk
Authorization
The SDK can be used by authenticated agent users of Moneytrans.
After this, it will be necessary to obtain authorization for the Wrapper/SDK, which will provide one necessary parameter for the configuration: ekycURL
.
curl --location '<API_ENDPOINT>/customer/idverification' \
--header 'Authorization: <SESSION_TOKEN>' \
Example response:
{
"ekycSessionId": "a6836bf6-xxxx-xxxx-xxxx-5a3ee22cd1ef",
"ekycURL": "https://idverification-cld-ts.moneytrans.eu/?token=323766c8-xxxx-xxxx-xxxx-f7cd8753bf53"
}
Usage
Basic Setup
HTML: Create a basic HTML structure where the SDK will be integrated.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>ID Verification Example</title>
</head>
<body>
<div id="idVerificationSdk"></div>
<script src="example.js"></script>
</body>
</html>
JavaScript: Use the SDK to load the iframe
after requesting camera permission.
// example.js
// Ensure the SDK is available
import { IdVerificationSDK } from 'mt-id-verification-sdk';
// Create a new instance of the SDK
const sdk = new IdVerificationSDK();
// SDK configuration
const config = {
elementRef: document.getElementById('idVerificationSdk'),
url: 'https://your-wrapper-url.com?token=XXX&uniqueId=XXX',
language: 'en',
needsCameraPermission: true,
onSuccess: (event) => {
console.log('Id verification completed:', event);
},
onError: (event) => {
console.error('Error:', event);
},
};
// Load the SDK
sdk.load(config).catch(error => {
console.error('Error loading SDK:', error);
});
Usage in Angular
Here is a basic example of how to use the SDK in Angular app:
import { AfterViewInit, Component, ElementRef, OnDestroy, ViewChild } from '@angular/core';
import { IdVerificationSDK, IdVerificationSdkConfig } from 'mt-id-verification-sdk';
@Component({
selector: 'app-root',
template: `<div #idVerificationSdk></div>`,
})
export class AppComponent implements AfterViewInit, OnDestroy {
@ViewChild('idVerificationSdk') idVerificationElement: ElementRef;
private sdk: IdVerificationSDK = new IdVerificationSDK();
ngAfterViewInit(): void {
const config: IdVerificationSdkConfig = {
elementRef: this.idVerificationElement.nativeElement,
url: 'https://your-wrapper-url.com?token=XXX&uniqueId=XXX',
language: 'en',
needsCameraPermission: true,
onSuccess: (event) => {
console.log('Id verification completed:', event);
},
onError: (event) => {
console.error('Error:', event);
},
};
// Load the SDK
this.sdk.load(config).catch(error => {
console.error('Error loading SDK:', error);
});
}
ngOnDestroy(): void {
this.sdk.destroy();
}
}
API
IdVerificationSDK
The IdVerificationSDK
class provides methods to load and destroy the iframe for ID verification.
Methods
load(config: IdVerificationSdkConfig): void
- Loads the iframe with the specified configuration.
destroy(): void
- Destroys the iframe and cleans up event listeners.
IdVerificationSdkConfig
The IdVerificationSdkConfig
interface specifies the configuration for loading the iframe.
Properties
elementRef: HTMLElement
- The HTML element where the iframe will be appended.
url: string
- The URL of the wrapper with the token attribute.
ekycURL
returned in the service/customer/idverification
*
language?: 'en' | 'es' | 'fr'
- Defaults to
en
.
- Defaults to
needsCameraPermission?: boolean
- Whether the SDK needs camera permission.
onSuccess: (event: any) => void
- A callback function that is called when the id verification is completed.
onError: (event: any) => void
- A callback function that is called when the id verification fails.