Configuring KRA App

This guide outlines the steps required to integrate CVL KRA PAN-based KYC verification via the CRM microservice. Integration involves two key components:

• CRM Configuration — Set up CVL KRA credentials.
• Backend Codebase — Invoke the CRM endpoint and process the response.

Index

• CRM Configuration
• Obtaining Credentials (UAT to Live)
• Backend Integration
• Conclusion

CRM Configuration

Configure the following fields in your CRM’s CVL KRA integration settings. Replace placeholder values with actual credentials provided by CVL.

Required Fields

Field	Description
Login Id	Provided by CVL onboarding team
Password	Associated password for your Login Id
Poscode	Unique POS code assigned to your organization
AES Key	Used for encrypting/decrypting payloads
API Key	Authorization key for API access

Obtaining Credentials (UAT to Live)

1. Request UAT Credentials (for test)
   Send an email from your registered company address to the CVL onboarding team.
   Email: api_integration@cvlindia.com
   You will receive: Login Id, Password, Poscode, AES Key, API Key.
2. Validate in UAT
   Add UAT credentials to CRM config. From your backend, call the CRM endpoint with sample PAN (ABCDE1234F) and verify responses.
3. Request Live Credentials 
   Once UAT validation is complete,
   create a WEB User o CVL portal in Users section and email CVL (api_integration@cvlindia.com) again to request Live credentials
   and also include WhiteList IP appearing on the configuration section on CRM
4. Add Live Credentials
   Replace UAT values in CRM configuration with Live credentials. Retest production calls.

Backend Integration

Call the CRM endpoint to trigger CVL KRA verification. The CRM handles the external CVL KRA request using stored credentials.

Environment Variables

CRM_API_HOST="https://cs.fabbuilder.com"
CRM_TENANT_ID="your_tenant_id"
CRM_KRA_SUBURL="cs-app/digio"

Endpoint

POST https://<CRM_API_HOST>/<CRM_KRA_SUBURL>/api/tenant/<CRM_TENANT_ID>/CvlKra/check-kyc
Body: { "pan": "ABCDE1234F" }

Example (Node.js + Axios)

import axios from 'axios';
import getConfig from './config';

export async function checkPanKyc(panNumber) {
  if (!panNumber) throw new Error('PAN required');

  const url = `${CRM_API_HOST}/${CRM_KRA_SUBURL}/api/tenant/${CRM_TENANT_ID}/CvlKra/check-kyc`;

  try {
    const result = await axios.post(url, { pan: panNumber }, { timeout: 10000 });
    const { isValid, message, kycData } = result.data || {};
    return {
      isValid: Boolean(isValid),
      message: message || '',
      kycData: kycData || null
    };
  } catch (err) {
    console.error('KYC check failed:', err?.response?.data || err.message);
    throw new Error('KYC verification failed');
  }
}

Conclusion

To integrate CVL KRA PAN-based KYC:

• Request UAT credentials from api_integration@cvlindia.com
• Validate integration in UAT
• Request and configure Live credentials
• Set backend environment variables
• Call /CvlKra/check-kyc via CRM to receive { isValid, message, kycData }