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.

Services we currently support
CategoryService Name DescriptionUse Cases
Asset & Vehicle AuthenticationVehicle RC AuthenticationAPI to Authenticate Vehicle Registration in IndiaVehicle RC authentication & owner check-in used car loan journeys
Commercial VerificationsGST AuthenticationAPI to authenticate 15 Digit GSTIN issued by the Goods and Service Tax Network in India.POI & POA in Commercial KYC verification
KYC OCRPAN OCRAPI to extract data from PAN cardAuto-filling of PAN data to reduce manual data entry during onboarding
Aadhar OCRAPI to extract data from Aadhar cardAuto-filling of Aadhar data to reduce manual data entry during onboarding
OCR ServicesCheque OCRAPI to extract data from a cheque leafAuto-filling of Bank account data to reduce manual data entry during onboarding
Driving License OCRAPI to extract data from Driving LicenseAuto-filling of DL data to reduce manual data entry during onboarding
Retail VerificationsPAN AuthenticationAPI to authenticate Permanent Account Number (PAN) issued by the Income Tax Department of India.PAN Authentication as Proof of Identity (POI) in Digital KYC
PAN Status CheckAPI to authenticate the status and details of a given PAN.PAN status check in customer-facing journeys
PAN Profile (Detailed)API to share the demographic/profile details of an Individual/Entity using a PANAuto-filling of verified PAN data to reduce manual data entry during onboarding
Aadhaar Number VerificationAPI to authenticate the 12-digit Aadhaar Number of a user.Basic Aadhar Number verification in customer-facing journeys
Aadhaar Offline KYC (XML Verification)API to validate the XML file of an Aadhaar cardOffline KYC during Full KYC
Utility Bills AuthenticationMobile AuthenticationAPI to authenticate current status of a Mobile Number and the connection type [Prepaid / Postpaid]Non-OTP-based mobile authentication in customer-facing journeys
Electricity Bill AuthenticationAPI to authenticate Electricity Bills / Customer ID issued by various Electricity Distribution Companies across India.Proof of Address in Retail KYC (where Aadhar is not available) and commercial KYC
Services we plan to support in the near future
CategoryService NameDescription
Banking AuthenticationBank AC VerificationAPI to verify bank account holder name basis IFSC and account number
Commercial VerificationsGSP GST Return FilingThe API provides the filing history of the particular GSTIN with the GST Network. Delay and Default fields in the API response are calculated for the following – GSTR 1, GSTR 3B, and CMP 08. The due date and number of days of delay for filing returns can also be fetched using an optional request parameter
MCA SignatoriesAPI to authenticate directors/partners of company/LLP
Company and LLP Master DataAPI to authenticate Company, LLP, FCRN and Foreign LLP Identification Numbers issued by the Ministry of Corporate Affairs (MCA)
Shop & EstablishmentAPI to authenticate Shop & Establishment Certificates issued by Municipal Authorities in selective parts of India (list of supported areas attached below in notes)
Digital Essentials – ContactabilityEmail AuthenticationAPI to authenticate email ID provided by the customers as part of the registration process
Employment & Income AuthenticationEPF AuthenticationAPI to authenticate Universal Account Number (UAN) issued by Employees Provident Fund Office (EPFO) in India, via OTP based Consent of the Account Holder
MiscellaneousCKYC SearchAPI to search basic details of individual from CERSAI portal
CKYC DownloadAPI to download individual details that are uploaded at CERSAI portal
OCR ServicesITR-V OCRAPI to extract data from Income Tax Return Acknowledgement Form (ITR-V) issued by the Income Tax Department of India
Retail VerificationsAadhaar XML Download (Aadhar eKYC)API to download the XML file on successful OTP validation (parsed XML O/P is shared in response)
Driver’s License AuthenticationAPI to authenticate Driver’s License issued by the Road Transport Offices of the States of India.
Voter ID (EPIC) AuthenticationAPI to authenticate Voters’ ID issued by the Election Commission of India.
Passport VerificationAPI to verify passports issued by Passport Seva Kendra basis File Number and Date of Birth
DigiLocker Account StatusAPI to check if the DigiLocker account exists for the given mobile number
DigiLocker Document ListAPI to get the list of all documents from the user’s DigiLocker Account
DigiLocker Document DownloadAPI to download the documents linked with user’s DigiLocker account

 

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.

LeadSquared KYC Integrations

4.1 API Authentication

CategoryEnvironmentBase URL
All Authentication APIs (excluding GST)User Acceptance Testing (UAT)https://testapi.karza.in
Production (Live)https://api.karza.in
GST Authentication APIsUser Acceptance Testing (UAT)https://gst.karza.in/uat
Production (Live)https://gst.karza.in/prod

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.

LeadSquared Karza Integration

 

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.).

Note: You can also enable multiple instances for each service. This allows you to create a separate instance (and field mapping) for the same service to cater to use cases like verifications of co-applicant, co-insurer, dependent, parental details, etc.
  1. Click Zoomto 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 .

LeadSquared Karza Integration

 

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 Icons 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 Checkbox 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 Icons 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.

LeadSquared Karza Integration

 

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 Icons tag will change to Icons.

Note: For all tested services, the API details, including the URL, attribute mapping, request body, and response, is available in the Karza Verification dashboard.
  1. On the main menu, navigate to Apps>Karza Verification.
  2. Alongside the service you want to test, click Icons.
  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.
Note: After you test a service, expand the API Details and API Response sections. Here you’ll find all the information (API URL, attribute mapping, post data, response) you require to configure the dynamic form rules and call the Karza service.

LeadSquared KYC Integrations

 

6.  Create a Dynamic Form for the KYC Process

Note: If you’re new to the Forms and Processes feature, see How to Create a Form. This section assumes you have some familiarity with setting up forms and form rules.

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).

LeadSquared Karza Integration

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.

LeadSquared Karza Integration

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.

LeadSquared Karza Integration

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.

LeadSquared Karza Integration

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.

LeadSquared Karza Integration

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.

Note: 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.

LeadSquared Karza Integration

 

Next Steps

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

 

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!

Was this Helpful?

Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments