Response Parameters

Returns following user details in JSON format:

#	Field Name	Description	Type	Max Length	Required [Yes/No]
1	Status	Response status code	String	100	Yes
2	Status Description	Response status description	String	100	Yes
3	Session ID	Client application identifier for the current session if any inputted	String	250	No
4	ValidationType	Indicates the type of account validation PV – PAN Validation, AV – Account Validation	String	2	Yes
5	MatchPercentage	Returns the % Match of the Account holder name given by Investor against the Name in Bank	String	100	Yes
6	BankName	Name of the Applicant’s Bank	String	100	Yes
7	IFSCCode	IFSC code of the Applicant’s Bank Account	String	11	Yes
8	AccountNumber	Bank Account number of the Applicant	String	20	Yes
9	AccountHolderName	Name of the Applicant as per the bank	String	100	Yes
10	AccountHolderNameOnBan k	Name of the Applicant as per the bank response	String	100	Yes

Sample Response (Encrypted)

{
"w3RM9DepF3rTUktV5D5u6Jz7Sq4Aal4sHh/n63nAszr5GeMf4+47mam9uGa+q1CJ6kI5/uYM4ugEh/ZALUFN1BrLtJLEMW2OPbZXaL5E9DT0liidq+X6vPB7pLvqNX5dXk1pycEqdO3ZlcBApF2v1J2dpfObOhBNcVl2v/w3RM9DepF3rTUktV5D5u6Jz7SNFw1AMGrhFUKXl2Ul34X+0liidq+X6vPB7pLvqNX5dXk1pycEqdO3ZlcBApF2v1J2dpfObOhBNcVl2v/w3RM9DepF3rTUktV5D5u6Jz7Sq4Aal4sHh/q4Aal4sHh/nYtga23bfY4DY+riMfCMx8…………...1AMGrhFUKXl2Ul34X+0liidq+X6vPB7pLvqNX5dXk1pycEqdO3ZlcBApF2v1J2dpfObOhBNcVl2v/w3RM9DepF3rTUktV5D5u6Jz7Sq4Aal4sHh/="

}

Sample Response (Plain)

{
 "UserID": "XXXX",
 "Password": "X$XXX$XXX",
 "SessionID": "26454520426145353738_BoTVKsp0yz",
 "Status": "CSS000",
 "ValidationType": "Y",
 "MatchPercentage": "50",
 "BankName": "XXXXXXXX",
 "IFSCCode": "XXXXX000045",
 "AccountNumber": "XXXX65465445",
 "AccountHolderName": "XXXXXXX",
 "AccountHolderNameOnBank": "XXXXXXX"
}

Sample Failure Response (Plain)

{
 "Status": "CSS002",
 "StatusDecription": "Invalid request",
 "BankValidationStatus": "N",
 "SessionID": "20220426145353738_BoTVKsp0yz"
}

Response Status Code

If the request fails, corresponding status code will be returned along with the status description in the response parameter. The following table lists the possible response status codes and description

#	Status Code	Status Description
1	CSS001	Your request decryption failed
2	CSS002	Invalid Request
3	CSS003	User id or password is a mandatory field
4	CSS004	API authentication failed
5	CSS005	Client setup pending
6	CSS006	Client is currently Inactive
7	CSS007	Your password has expired
8	CSS018	SessionID is mandatory field
9	CSS019	Invalid Pan
10	CSS020	Invalid Account Number
11	CSS021	Invalid IFSC Code
12	CSS022	Pan should not be Empty
13	CSS023	Account Number should not be Empty
14	CSS024	IFSC Code should not be Empty
15	CSS025	Bank Validation API not allowed
16	CSS008	Unauthorized API access