Skip to content

Web Onboarding Commands

Alice Onboarding Web SDK can be used in two different ways, by commands (OnboardingCommands) or by full flow (Onboarding). The commands allow you to open the capturer and do a series of operations independently.

In this mode the process is completely free. Your application manages the beginning and end of it, as well as the capture and upload of the different documents to the API. This case is indicated for an expert level of configuration, allowing you to split the onboarding process into different stages and to get rid of intermediate screens.

Available operations are as follows:

  • Get user status
  • Get supported documents
  • Add selfie
  • Create document
  • Add document
  • Authenticate
  • Add other trusted document

Initialize Onboarding Commands

If you don't know how to get the userToken please review the Authentication section.

let config = new aliceonboarding.OnboardingConfig()
    .withCustomLocalization({language: "en"});

let onboardingCommands =  await OnboardingCommands.makeOnboardingCommands(
    "alice-onboarding-mount",
    userToken,
    config
);

Get user status

It returns the Alice Onboarding User Status

  • Parameter onSuccess: the callback that will be called when the user status is received.
  • Parameter onError: the callback that will be called when there is an error.
onboardingCommands.getUserStatus(

    (userStatusResult) => { // onSuccess
        console.log(userStatusResult)
    },
    (error) => { //onError
        console.error(error)
    }
);

Get supported documents

It returns the Alice Onboarding supported documents (hierarchically sorted).

  • Parameter onSuccess: the callback that will be called when the response is received.
  • Parameter onError: the callback that will be called when there is an error.
onboardingCommands.getDocumentsSupported(
    (suportedDocuments) => { // onSuccess
        console.log(suportedDocuments)
    },
    (error) => { //onError
        console.error(error)
    }
);

Add selfie

It presents an Alice Onboarding Selfie Capture View sending a video directly to Alice Onboarding platform.

  • Parameter onSuccess: the callback that will be called when the selfie was added.

  • Parameter onError: the callback that will be called when there is an error.

  • Parameter onCancel: the callback that will be called when the user cancels the capture.

  • Parameter selfieStageConfig: (optional) see Selfie stage configuration parameters. Default configuration:

    • capturerType: SelfieCapturerType.CAMERA.

    Warning

    The parameter capturerType and the enum aliceonboarding.SelfieCapturerType will disappear from version 6.0.0.

    • automaticCapture: true.
    • cameraType: CameraType.FACE.

    Note

    Commands mode only admits the capturer SelfieCapturerType.CAMERA.

onboardingCommands.addSelfie(
    (successResult) => { // onSuccess
        console.log(successResult);
},
    (error) => { //onError
        console.error(error);
    },
    () => { //onCancel
        console.log("Selfie capture canceled");
    }
);

onboardingCommands.addSelfie({
    onSuccess: (successResult) => {
        console.log(successResult);
    },
    onError: (error) => {
        console.error(error);
    },
    onCancel: () => {
        console.log("Selfie capture canceled");
    }
});

Create document

It creates a document given the type and the issuingCountry:

  • Parameter documentType: DocumentType.
  • Parameter issuingCountry: string value. You can check supported documents with the command getDocumentsSupported.
  • Parameter onSuccess: the callback that will be called when the document is created.
  • Parameter onError: the callback that will be called when an error occurs.

Note

On onSuccess returns a result with the document_id on the success content. This identifier (documentId) is necessary to add documents.

onboardingCommands.createDocument(
    DocumentType.PASSPORT,   //documentType
    "ESP",                   //issuingCountry
    (result) => {            //onSuccess
        console.log(result.document_id)   //returns the document id of the created document
        },
    (error) => {              //onError
        console.error(error)
        }
    );

onboardingCommands.createDocument({
    documentType: DocumentType.PASSPORT,
    issuingCountry: "ESP",
    onSuccess: (result) => {            //onSuccess
        console.log(result.document_id)   //returns the document id of the created document
        },
    onError: (error) => {              //onError
        console.error(error)
        }
    });

Add document

It presents an Alice Onboarding Document Capture View sending images to Alice Onboarding platform

  • Parameter onSuccess: the callback that will be called when the document was captured.
  • Parameter onError: the callback that will be called when an error occurs.
  • Parameter onCancel: this callback that will be called when the user cancels the capture.
  • Parameter documentId: document identifier given by createDocument command.
  • Parameter documentType: DocumentType.
  • Parameter issuingCountry: string value. You can check supported documents with the command getDocumentsSupported.
  • Parameter documentSide: string value. Side of the document (front or back).

  • Parameter documentStageConfig: (optional) See Document stage configuration parameters. Default config:

    • capturerType: DocumentCapturerType.CAMERA.
    • automaticCapture: true.
    • cameraType: CameraType.BACK.

    Note

    Commands mode only admits the capturer DocumentCapturerType.CAMERA.

onboardingCommands.addDocument(
    (result) => { //onSuccess
        console.log(result)
    },
    (error) => { //onError
        console.error(error)
    }
    (cancel) => { //onCancel
        console.error(cancel)
    },
    result.document_id,        //with the document_id of the previously created document, look at the previous command.
    DocumentType.PASSPORT,      //documentType
    "ESP",                     //issuingCountry
    "back",                     //documentSide  (front or back)
);

onboardingCommands.addDocument({
    onSuccess: (result) => { //onSuccess
        console.log(result)
    },
    onError: (error) => { //onError
        console.error(error)
    }
    onCancel: (cancel) => { //onCancel
        console.error(cancel)
    },
    documentId: result.document_id, //with the document_id of the previously created document, look at the previous command.
    documentType: DocumentType.PASSPORT,
    issuingCountry: "ESP",
    documentSide: "back",           //(front or back)
});

Authenticate

It presents an Alice Onboarding Authenticate Capture View sending a video directly to Alice Onboarding platform and checking if user is Login allowed or not.

Warning

The user must be already enrolled and authorized.

  • Parameter onSuccess: the callback that will be called when the authentication is done.
  • Parameter onError: the callback that will be called when an error occurs.
  • Parameter onCancel: this callback that will be called when the user cancels the authentication.
  • Parameter automaticCapture: flag to set automatic or manual capture (default value is true).

  • Parameter cameraType: type of camera to use. The enum aliceonboarding.CameraType can be used to indicate the camera.

    Default value is CameraType.FACE meaning that the camera facing the user will be used. You can set it to CameraType.BACK to use rear camera. This argument is only used when there are available different cameras on the device.

onboardingCommands.authenticate(
    (result) => { // onSuccess
        console.log(result)
    },
    (cancel) => { //onCancel
        console.error(cancel)
    }
    (error) => { //onError
        console.error(error)
    }
);

onboardingCommands.authenticate({
    onSuccess:(result) => {
        console.log(result)
    },
    onCancel: (cancel) => {
        console.error(cancel)
    }
    onError: (error) => {
        console.error(error)
    }
});

Add other trusted document

It presents an Alice Onboarding Other Trusted Document Capture View sending a PDF file to Alice Onboarding platform

  • Parameter onSuccess: the callback that will be called when the document was captured.
  • Parameter onError: the callback that will be called when an error occurs.
  • Parameter onCancel: this callback that will be called when the user cancels the capture.
  • Parameter category: this argument is required if your flow requires multiple documents. You must use this argument to tag each document, for example if your flow requires an invoice and a payslip you could use "invoice" and "payslip" as categories. Note: this argument is case insensitive.
onboardingCommands.addOtherTrustedDocument(
    (result) => { //onSuccess
        console.log(result)
    },
    (error) => { //onError
        console.error(error)
    }
    (cancel) => { //onCancel
        console.error(cancel)
    },
    category
);

onboardingCommands.addOtherTrustedDocument({
    onSuccess: (result) => {
        console.log(result)
    },
    onError: (error) => {
        console.error(error)
    }
    onCancel: (cancel) => {
        console.error(cancel)
    },
    cateogry: category
});

Removing Alice Onboarding Commands

If you are running the onboarding commands mode, you can call the unmount method to cancel the capture. The first step is to initialize the Alice Command Mode as follows:

let onboardingCommands = new aliceonboarding.OnboardingCommands(
    "alice-onboarding-mount",
    userToken,
    config
    );

let onboardingCommands = new aliceonboarding.OnboardingCommands({
    idSelector: "alice-onboarding-mount",
    userToken: userToken,
    config: config
    });

When you want to unmount the Alice component you only have to call the following method:

onboardingCommands.unmount();

Onboarding client

Since version 4.30 in addition to the commands mode the class OnboardingClient is available allowing an easier integration for those integrators who want to consume the API directly. This class the following static methods:

static getStatus(userToken);
static createDocument(userToken, type, issuingCountry);
static addDocument(userToken, documentId, image, side, manual, webcam);
static addSelfie(userToken, video);
static supportedDocuments(userToken);
static authenticate(userToken, video);
static addOtherTrustedDocument(userToken, pdf, category);
static unmount();