QoreID Web SDK

This guide provides information on how to integrate the QoreID SDK with your web application. With the QoreID SDK, you can more conveniently access QoreID services.


With this release, customers can perform Collection services like VeriFind (digital address verification), Passport, Driver's License and other QoreID services. Workflow will be available in a future release.


  • QoreID web SDK can be used on ECMAScript 5 and above supported browsers. You can confirm your browser's version compatibility on caniuse.com.


The Web SDK can be integrated within seconds by adding these few lines of code to your website.

<script type="text/javascript" src="https://dashboard.qoreid.com/qoreid-sdk/qoreid.js"></script>

By adding the scripts to your website head you can use the qoreid-button Element on your site.

  productCode="// PRODUCT_CODE"
  customerReference="// CUSTOMER_REFERENCE"
  applicantData="// {APPLICANT_DATA_OBJECT}"
  identityData="// {IDENITY_DATA_OBJECT}"
  addressData="// {ADDRESS_DATA_OBJECT}"
  ocrAcceptedDocuments="// OCR_ACCEPTED_DOCUMENT"
  onQoreIDSdkSubmitted="// ON_SUBMIT_CALLBACK"
  onQoreIDSdkError="// ON_ERROR_CALLBACK"
  onQoreIDSdkClosed="// ON_CLOSE_CALLBACK"

SDK Button Attribute Options

  • clientId
    Your QoreID client ID (as obtained from your QoreID portal).

  • flowId (optional)
    ID of a workflow you have created on your QoreID Portal dashboard.

  • ProductCode
    Value representing a QoreID service product. See the list of available Product Code options

    Where a flowId value is not specified then a productCode value is required.

  • customerReference
    A value to be used as an identifier for a customer who is the subject of this verification

  • applicantData
    Data about an individual who is the subject of a verification.

      applicantData='{"firstname": "// APPLICANT_FIRSTNAME","middlename": "// APPLICANT_MIDDLENAME", "lastname": "//  APPLICANT_LASTNAME", "gender": "// APPLICANT_GENDER", "dob": "// APPLICANT_DOB (YYYY-MM-DD)", "phone": "// APPLICANT_PHONE_NUMBER", "email": "// APPLICANT EMAIL"}'>
  • identityData
    Details for identity verification

        identityData='{"idType": "// IDENTITY_TYPE", "idNumber": "// IDENTITY_NUMBER"}'>
  • addressData
    Details for address verification

        addressData='{"address": "// ADDRESS", "city": "// CITY", "lgaName": "// LGA_NAME"}'>
  • ocrAcceptedDocuments
    For an OCR id scan, list of documents to be considered is required. See the list of Accepted Documents

  • hideButton
    Trigger the web SDK element without its default button. This can be used when launching the SDK screen with a custom button or directly from code

  • onQoreIDSdkSubmitted
    Accepts a callback to be triggered when there is an onSubmitted event

  • onQoreIDSdkError
    Accepts a callback to be triggered when there is an onError event

    • onQoreIDSdkClosed
      Accepts a callback to be triggered when there is an onClosed event

Alternative callback events

The following script can be used to handle triggered event on the qoreid-button element.

  const button = document.getElementById("QoreIDButton");

  // setup callbacks
  button.addEventListener('qoreid:verificationSubmitted', ({ detail }) => {
    console.log('submitted payload', detail)
  button.addEventListener('qoreid:verificationError', ({ detail }) => {
    console.log('error payload', detail)
  button.addEventListener('qoreid:verificationClosed', ({ detail }) => {
    console.log('closed payload', detail)