Change Logs

This document logs all modifications made to the KYC Web SDK, keeping our partners informed of the most recent version.

Each release is organized by tags. These tags give you a quick idea of the changes—whether they include new features, bug fixes, or important security updates.

Feature: New functionalities and enhancements in this release.

Bug Fixes: Resolving issues and glitches for a smoother experience.

Security Update: Updates addressing potential vulnerabilities for improved security.

Device Support: Added support to device versions.

Performance Improvement: Optimisations for faster and more efficient usage.

Releases

1.2.0

Feature

Date: Aug 18th, 2026

New Workflow for - Identity Verification Authoritative, for Indonesia ( Indo KYC Flow )

New verificationType: 'authoritative' option in workflowConfigs.identityVerification enables a full step-up KYC flow for Indonesian users, orchestrated by the backend:

Doc Capture → OTP Verification → Personal Info Review → Demographic Verification → Liveness → Face Match

VidaSDK.init({
  workflow: 'identity-verification',
  workflowConfigs: {
    identityVerification: {
      verificationType: 'authoritative',   // ← new
    },
  },
});

Key capabilities:

• OTP verification - users verify their phone number via OTP delivery channel (SMS, WhatsApp.)

• KTP Capture - users capture their KTP to perform Doc Verification/OCR

• Personal Info (PI) review - extracted OCR fields (NIK, name, DOB, etc.) are displayed for review; editable fields can be corrected before submission

• Demographic verification - ID data is matched against authoritative registry

• Liveness + Face Match - stitched automatically after demographic verification passes. Face match done against authoritative registry.

• Manual review flow - if submission triggers a manual review queue, the SDK shows a "review in progress" screen and surfaces the result when ready

• Resume flow - returning users with the same clientTransactionId resume from the step they left off;

• Fraud Shield - ID Fraud Shield runs automatically at the final KYC step for, if enabled.

Single NPM Build for Sandbox & Production

For customers using npm integration - init() now accepts an optional env parameter. The NPM package is now a single build that targets both sandbox and production; the environment is selected at runtime via this param (previously required separate packages for sandbox and production).

yarn add vida-web-sdk -OR- npm install vida-web-sdk

VidaSDK.init({
  env: 'sandbox',      // or 'production' (default)
  ...
});

Theme Config - Link Text Button Colours

Three new optional keys added to themeConfigs for customising hyperlink-style buttons (used in introduction / OTP screens, etc):

themeConfigs: {
  linkTextButtonColor?: string;
  linkTextButtonHoverColor?: string;
  linkTextButtonDisabledColor?: string;
}

Geo-X KYC SDK flow : UI Improvements

• IDV Introduction screen - refreshed layout and icon sizing

• IDV Error screen - layout and messaging improvements; Updated warning icon used; Alert box for remaining attempts and max attempts exhausted cases;

• In ID Card capture screen - highlighted capture feedback text

Liveness SDK : Tutorial screen changes - Updated the tutorial images and text contents. New fields for locale customization.

1.1.3

CDN:

Sandbox : https://web-sdk.vida.id/1.1.3/sandbox/vida-web-sdk.js Prod : https://web-sdk.vida.id/1.1.3/vida-web-sdk.js

NPM:

Sandbox : yarn add vida-web-sdk@1.1.3-sandbox / npm install vida-web-sdk@1.1.3-sandbox Prod : yarn add vida-web-sdk / npm install vida-web-sdk

Feature

Date: Jul 21th, 2026

• VidaSDK.preload() - Introduced a new method which preload() prefetches SDK assets in the background so they are already cached when the SDK starts the flow. This reduces perceived load time for the end user.

• userInfo.Id is made an optional parameter for init() method now for Liveness+Id Fraud shield combined offering.

• Added an exit confirmation pop-up if user tries to manually close the modal during the process, if there is a retry or flow completion possibility.

1.1.1

CDN:

https://web-sdk.vida.id/1.1.1/sandbox/vida-web-sdk.js

NPM:

https://www.npmjs.com/package/vida-web-sdk

Feature

• Separate handling of front and back ID images for more adaptable verification flows.

• Enhanced callback responses with more detailed status information to improve visibility during the verification process.

• Integration with the ID Fraud Shield SDK, enabling risk-based actions across both Liveness and KYC flows.

Security Update

Enhanced fraud detection through combined KYC and risk-based validation.

1.1.0

CDN:

https://web-sdk.vida.id/1.1.0/sandbox/vida-web-sdk.js

NPM:

https://www.npmjs.com/package/vida-web-sdk