Function call

What is a function call

Metamap verification process can be started programmatically via function call.

When should you use function call

You should use function call when you want to start verification process programmatically.

Importing scripts

In order to use function call on your page you will need to add button.js to your page like so

<script src="https://web-button.getmati.com/button.js"></script>

This script will expose MetamapVerification class in window object.

Instantiating verification

Instantiate verification from MetamapVerification class.

const configuration = {
  clientId: "your_client_id",
  flowId: "your_flow_id",
};
const verification = new MetamapVerification(configuration);

const configuration = {
  clientId: "your_client_id",
  flowId: "your_flow_id",
};
const verification = new MetamapVerification(configuration);

Learn how to obtain client and flow ids here.

Configuration

Configuration is done via configuration object passed as an argument into MetamapVerification constructor. You can find complete list of parameters here

Add event listeners

You can add listeners for verification events using .on method.

verification.on('metamap:userStartedSdk', ({ detail }) => {
  console.log('started payload', detail)
});
verification.on('metamap:userFinishedSdk', ({ detail }) => {
  console.log('finished payload', detail)
});

verification.on('metamap:userStartedSdk', ({ detail }) => {
  console.log('started payload', detail)
});
verification.on('metamap:userFinishedSdk', ({ detail }) => {
  console.log('finished payload', detail)
});

You can remove listeners by using .off method. Note that you will need to pass the same reference to a function that was passed to .on method.

const handler = ({ detail }) => {
  console.log('started payload', detail)
};

verification.on('metamap:userStartedSdk', handler);
verification.off('metamap:userStartedSdk', handler);

const handler = ({ detail }) => {
  console.log('started payload', detail)
};

verification.on('metamap:userStartedSdk', handler);
verification.off('metamap:userStartedSdk', handler);

Starting verification

In order to start verification process call .start method on verification instance.

verification.start();

verification.start();

Verification instance methods

Method name	Description	Arguments
`on`	Subscribe to verification event.	`eventName: string`, `callback: (data: { detail: { identityId?: string, verificationId: string } \| null }) => void`
`off`	Unsubscribe from verification event. Note that to unsubscribe you must pass same function reference to callback argument of off method that was passed to on method.	`eventName: string`, `callback: (data: { detail: { identityId?: string, verificationId: string } \| null }) => void`
`start`	Start verification	`n/a`

Events

Event name	Description	Payload
`metamap:loaded`	Indicates that verification scripts are loaded. Emitted before verification itself starts.	n/a
`metamap:userStartedSdk`	Indicates that user has started verification process. Emitted just after verification was created.	identityId, verificationId
`metamap:userFinishedSdk`	Indicates that user finished verification process. Emitted when user reaches final screen.	identityId, verificationId
`metamap:exitedSdk`	Indicates that user exited verification before finishing it. Emitted when user chooses to exit verification.	identityId, verificationId
`metamap:continuedOnAnotherDevice`	Indicates that user chose to continue redirection on another device. Emitted when use chooses redirection method.	identityId verificationId