Karza Connector for KYC

1. Feature Overview

Karza Technologies offers Know Your Client (KYC) verification solutions for commercial, retail, financial, and banking services. Integrate LeadSquared with Karza to leverage their KYC verification services directly from your LeadSquared account.

Once integrated, you can use LeadSquared Forms and LeadSquared Portals to seamlessly verify KYC details like PAN, Aadhar, GST, Address, Mobile, Vehicle Registration Certificate, etc.

2. Prerequisites

• You must be the Administrator of your LeadSquared account to install and configure this connector.
• You must have a Karza Account with access to their API collection for the required services.
• This is a paid feature. To enable it, reach out to your account manager, or write to support@leadsquared.com.

3. How it Works

First, install, configure and test the Karza connector. Next, create a dynamic form to facilitate the actual KYC verification for the end user. Using form rules, call the relevant connector service, and map the response from Karza to display the KYC verification results and data to the end user. You can map the response to an additional field in the form such as ‘Is PAN Verified’, ‘Verification Status’, etc.

The Karza integration requires the following steps –

1. Install and configure the Karza connector.
   1. Choose the required services (Retail Verification, Commercial Verification, Asset and Vehicle Verification, etc.).
   2. Map system/custom fields in LeadSquared (e.g., lead/opportunity/activity fields) to the attributes required by Karza for the chosen services.
2. Use the Karza dashboard to test the connection for each service.
   The Karza dashboard provides a convenient tool to test the connection between LeadSquared and Karza, and access success/failure responses for each service.
   
   1. An API URL is generated for each service.
   2. Choose a lead to test the API and obtain a response.
   3. Note the attributes in the response payload.
3. Create a dynamic form to facilitate the KYC process for the end user.
   1. Add the lead/opportunity details to the form (PAN number, Aadhaar number, GSTIN, etc.).
   2. Add an additional field to show the result of the KYC verification to the end-user.
      • For example, you can use fields like ‘Is PAN Verified’, ‘Is Aadhaar Verified’, etc.
      • Use additional fields to capture other data points returned by Karza.
   3. Use form rules to call the relevant API (available in the Karza dashboard for each service) and populate the additional field (that’s shown to the end-user, e.g., the ‘Is PAN Verfied’ field) with the verification response from Karza.*
   4. Publish the form
      • Embed the form in a work area within the LeadSquared application using the Process Designer.
      • Embed the form in a self-serve portal using the Portals Designer.

* Each service returns a user-friendly success (e.g., “Authentication Successful”) or error message (e.g., “Number to be authenticated seems invalid”) in the status.message response parameter.

4. Install and Configure the Connector

1. From your LeadSquared account, navigate to Apps>Apps Marketplace.
2. Search for Karza, and click Install.
   • Alternatively, you can find the connector on the left panel, under Verifications.
3. Once installed, hover your cursor over , and click Configure.

4.1 API Authentication

Enter the following –

1. Base URL (For all Authentication API(s) except GST).
   The base URL provided by Karza for KYC, Utility Bill, Asset and Vehicle, Employment and Income, Bank and Payments Authentication APIs.
2. Base URL (For GST Authentication API(s)).
   The base URL provided by Karza for GST Authentication APIs.
3. API Key
   The API provided by Karza for the Authentication APIs.

Click Save & Next when you’re done.

4.2 Manage Services

Available services are listed under each category. Select a category (Retails Verification, Commercial Verification, etc.), then select the services you want to enable (PAN Authentication, Aadhar Number Verification, etc.).

1. Click to Enable multiple instances.
2. The primary instance is created by default. Click Add Instance.
3. Enter a name for the new instance – e.g., ‘Co-Applicant’.
   • To remove an instance, alongside the instance name, click .

4.3 Request Mapping

For each service, map the attributes required by Karza with the corresponding LeadSquared fields. If you’ve enabled multiple instances of a service, be sure to map the required fields for each instance. For each service the following statuses are displayed – Not Mapped, Partially Mapped, Fully Mapped.

1. Alongside each attribute, click to view the attribute name.
2. The input requirements for each field are specified.*
3. Select the LeadSquared entity (lead/activity/opportunity) and the entity field (e.g., PAN Number) to map to the attribute.
4. For services with multiple instances, you can use the Same as Primary to inherit the mapping configured in the primary instance.
5. Your mapping configurations are not autosaved. Click Save Mapping to save your configurations at each step, or after mapping all attributes. Close the configuration pop-up when you’re done.

Note: *For some attributes, the Regular Expression (Regex) is specified.  You can copy the expression and use it directly in the Regex capability present at the field-level validation properties section while creating a dynamic form in LeadSquared.

5. Test the Services

After installation and configuration, navigate to the Karza Verification Dashboard and test each service to ensure the connection is established and working as expected. After you test each service, the tag will change to .

1. On the main menu, navigate to Apps>Karza Verification.
2. Alongside the service you want to test, click .
3. The basic details are pre-populated. Enter setup instructions, and then click Next.
4. Alongside the API Request URL, click View Details.
   • This is the API URL you’ll call to test the service. It’s also the URL you’ll use to call service from your dynamic form.
   • Here, you can change the attribute-field mapping pre-configured at the connector level. Note that any changes made here will update the mapping of that attribute across all services where it’s used. If you made any changes, click Save and close the pop-up.
   • Click Next to proceed to the Test API step.
5. Search for a lead using the lead’s complete email address. Click Search, then select the lead from the search results.
   The request attributes being passed in the request to Karza will be displayed (this is helpful for testing in UAT accounts, to ensure the data being passed in the request is valid).
   Also, you can select an activity type/opportunity type and the activity/opportunity instance to test the service.

6.  Create a Dynamic Form for the KYC Process

After testing the enabled Karza services, set up a seamless KYC process for the end-user using dynamic forms –

1. Create a new form or edit an existing one. For more details, see How to Create a Form.
2. Add the lead/activity/opportunity fields required for KYC to the form.
   • Ensure these fields were mapped correctly during the connector configuration and testing.
   • Add the Regex to the field-level validation properties.
3. Add the relevant rules.

Example – PAN OCR and PAN Verification Services

In this example, we set up a dynamic form where –

1. We use Karza’s PAN OCR service to extract information from an uploaded PAN card document
2. We use Karza’s PAN Authentication service to verify the PAN card details

We’re using a multi-step form for this example. In the first step, we capture the customer’s mobile number, consent, and PAN document (using a custom field set).

In the second step of the form, we use a boolean field, ‘Trigger PAN OCR’, to trigger the call to Karza’s OCR service, and populate the Name, PAN Number, and Date of Birth fields with the response.

This is set up using the following example rule –

If ‘Trigger PAN OCR’ is true,
Then Set Value of Field ‘Name as per PAN’, ‘PAN Number’, and ‘Date of Birth’ using Data From API – POST <API URL, post data obtained from Karza verification dashboard> and map the specific response parameters to set the field values.

All the details of the service (API URLs, Post Data, Mappings, Responses, etc) to enter in the form rule are available on the Karza Verification Dashboard.

In the third step of the form, we call Karza’s PAN Authentication service to verify the PAN card details. We use a boolean field, ‘Trigger PAN Auth’, to trigger the call to Karza’s service, and populate the response in the ‘PAN Authentication Status’ field.

Here’s the sample form rule used to set this up –

If ‘Trigger PAN Auth’ is true,
Then Set Value of Field ‘PAN Authentication Status’ using Data From API – POST <API URL, post data obtained from Karza verification dashboard> and map the specific response parameters to set the ‘PAN Authentication Status’ field values.

Next Steps

When you’re done, Publish the form. Next –

• Use the process designer to embed it in a work area on LeadSquared.
• Use the portal designer to embed the form in a self-serve application portal.

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!