Skip to main content
Integrate EntityLocker business document retrieval into your web application using the JavaScript SDK. The SDK provides a pre-built interface that handles the complete EntityLocker flow.
1

Create a session

Before initializing the SDK, you must create a unique session. Each SDK instance requires its own session to ensure secure and independent interactions.Use the Create Session endpoint to generate this session. This is a server-side API call that uses Sandbox Authentication to validate your credentials.Once created, you’ll receive a session_id, which you’ll need when initializing the SDK on the client side.
2

Add the SDK script

Include the EntityLocker SDK script in your HTML page.
<script src="https://sdk.sandbox.co.in/kyc/entitylocker/sdk.js"></script>
The SDK is loaded globally and available as EntitylockerSDK.
3

Initialize the SDK

Configure and launch the EntityLocker SDK when the user initiates document retrieval.

3.1 Basic implementation

<button onclick="launch()">Fetch with EntityLocker</button>

<script>
  function launch() {
    // Set your API key
    EntitylockerSDK.setAPIKey("YOUR_API_KEY");

    // Configure the SDK options
    const options = {
      session_id: "a7fac865-61a9-4589-b80c....", // Replace with your session ID from Step 1
      brand: {
        name: "MoneyApp", // Your business or app name
        logo_url: "https://example.com/your_logo", // Publicly accessible URL of your logo
      },
      theme: {
        mode: "light", // Options: "light" or "dark"
        seed: "#3D6838", // Primary color for theme customization
      },
    };

    // Launch the EntityLocker SDK
    EntitylockerSDK.open(options);
  }
</script>

{
  "session_id": "a7fac865-61a9-4589-b80c....",
  "brand": {
    "name": "MoneyApp",
    "logo_url": "https://example.com/your_logo"
  },
  "theme": {
    "mode": "light",
    "seed": "#3D6838"
  }
}
​
session_id
string
required
Unique session ID generated when Create Session API is called.
​
brand
object
required
Configuration for branding displayed in the EntityLocker interface.
​
theme
object
required
Appearance configuration for the SDK.
4

Handle SDK events

Set up an event listener to handle SDK events indicating session completion, cancellation, or errors.
// Define a custom event listener to handle SDK events
class EventListener extends EntitylockerSDK.EventListener {
  constructor(callback) {
    super();
    this.callback = callback;
  }
  onEvent(event) {
    if (this.callback) {
      this.callback(event);
    }
  }
}

// Define a callback function to process events from the SDK
const handleEvent = (event) => {
  console.log("Received event:", event);
  
  switch (event.type) {
    case "in.co.sandbox.kyc.entitylocker_sdk.session.completed":
      // Documents were fetched successfully
      // Proceed with your application flow
      fetchDocumentsFromBackend(sessionId);
      break;

    case "in.co.sandbox.kyc.entitylocker_sdk.session.closed":
      // User closed or exited the SDK
      showMessage("Document retrieval cancelled");
      break;

    default:
      console.log("Unhandled event:", event);
  }
};

// Initialize the event listener with your callback
const eventListener = new EventListener(handleEvent);
EntitylockerSDK.setEventListener(eventListener);
To programmatically verify the final status of a session, call the Session Status endpoint from your backend.

​
Event types

The SDK emits the following event types:
Event TypeDescription
in.co.sandbox.kyc.entitylocker_sdk.session.completedUser successfully completed the EntityLocker flow and documents were retrieved
in.co.sandbox.kyc.entitylocker_sdk.session.closedUser closed the SDK without completing the flow

​
Next steps

Create Session API

Learn how to create sessions for the SDK

Session Status API

Monitor session progress and status

Fetch Document API

Retrieve document data after completion