Implement Identity Verification with Jumio on the Web

Implement identity verification on your web page.

Before you start

Before you begin, you already have a working Live Experience-enabled web page, to which you are adding an identity-verification engagement scenario.

Here's what to do

1. Implement the call logic like you would for any other engagement scenario, but set the appLocation value to the engagement scenario that has the identity verification service enabled.
   For example, if you are using the default identity verification engagement scenario to deliver the identity verification service, set appLocation to "Know Your Customer":

   .
   .
   .
   liveApi.controller.settings.startVideoInFullScreen = true;
   liveApi.controller.contextAttributes.set("appLocation", "Know Your Customer");
   liveApi.controller.addComponent();
   .
   .
   .

2. Optionally, enable Jumio`s facial recognition service, which compares and verifies the likeness of the faces of the person scanning their identity card and the picture on the card.
   The Jumio assessment is reported to the associate in the Live Experience Associate Desktop. Add the following line of code beneath the context attribute setting appLocation: liveApi.controller.settings.attemptFaceMatchWhenVerifyingIdentity = true;.
3. Develop your web page to listen for specific Jumio live events and notifications and implement your own responses.
   • ID verification is complete. liveApi.controller.events.LivePreCallIDCheckComplete
   • ID verification is incomplete. liveApi.controller.events.LivePreCallIDCheckIncomplete
   • ID verification is cancelled. liveApi.controller.events.LivePreCallIDCheckCancelled
   • ID verification failed. liveApi.controller.events.LivePreCallIDCheckFailed
   • ID verification progress indicator, a Boolean parameter that indicates whether the component is busy or ready. liveApi.controller.events.LiveProgressIndicator

In this example, you are listening to the progress indicator to show a busy spinner while verification is in progress, and then stopping the spinner when the progress indicator is ready:

document.querySelector("body").addEventListener(
 liveApi.controller.events.LiveProgressIndicator, (status) => {
 console.log(status ? "Component Busy (show busy spinner)" : "Component Ready (stop busy spinner)");
 });

Or, you could listen for when the verification results are obtained so that you can obtain the associated Jumio reference code (which you can use in REST API calls to the Jumio API):

document.querySelector("body").addEventListener(liveApi.controller.events.LivePreCallIDCheckComplete, this.appEventHandler.bind(this));
appEventHandler(event) {
 const detail = event.detail;
 console.log("appEventHandler: Got event: " + event.type, detail);
 if (event.type === liveApi.controller.events.LivePreCallIDCheckComplete) {
 console.log("kycScanReference: " + liveApi.controller.service.kycScanReference);
 }
 ...

See the complete list of Live Experience notification events for the web: Oracle Live Experience JavaScript API Reference.