Error Codes

As the LSP-Lender APIs are async, there are two different places where the error can be thrown. First is as part of the Ack and the second is as part of the Actual Response. The error messages can be classified depending on where they appear

  1. Errors captured inside Ack object - Errors captured inside Ack object are at a very basic level. These include errors which can be immediately flagged without having to do a lot of processing
    a. Security Errors - Errors related to signature mismatch
    b. Validation Errors - Errors like missing mandatory attributes, incorrect values passed for an ENUM field etc.
  2. Response API Errors - These are the errors captured inside Response node of the actual Response API - Each Response API that hits the LSP has a dedicated object called Response. This object will capture all the API level business errors. For example, if there are errors in CreateLoanApplicationRequest, they will be captured inside the Response object of the CreateLoanApplicationResponse payload. These can be of two types
    a. Business Errors - Errors related to the business logic implemented in each APIs
    b. System Errors - Errors related to the auxiliary systems to which the lender system talks to like AA, Credit Bureaus, PCR etc

Errors captured inside Ack Object

Validation Errors

Sl No

Error Code

Description

1

GEN5001

Mandatory Attribute missing

2

GEN5002

Value provided not in ENUM

3

GEN5003

Method Type Not Allowed

4

GEN5004

Service Unavailable

5

GEN5005

Invalid api version

6

GEN5006

Request Timed Out

7

GEN5007

Invalid attribute Length

Security Errors

Sl No

Error Code

Description

1

AUTH1001

Invalid signature

API Errors

CreateLoanApplicationResponse

Sl No

Error Code

Description

1

CLARQ1001

Loan type not supported

2

CLARQ1002

CreationDate cannot be greater than current time

3

CLARQ1003

Requested loan amount exceeds limit

4

CLARQ1004

Corrupted API Payload for collateral data

5

CLARQ1005

Corrupted API Payload for borrower data

ConsentHandleResponse

Sl No

Error Code

Description

1

CHRQ4001

Invalid vua

2

CHRQ4002

LoanApplicationId not found

3

CHRQ4003

isAggregation enabled flag is set to True but no ConsentAggregationId found

4

SYS4004

AA server down

5

SYS4004

AA server Request time out

GenerateOffersResponse

Sl No

Error Code

Description

1

GORS2001

Invalid LoanApplicationId

2

GORS2002

Consent for fetching data from AA expired

3

SYS2003

AA system down

4

SYS2004

Data fetch from AA failed

5

SYS2005

Data fetch from AA timed out

6

SYS2006

BRE system down

7

SYS2007

BRE processing failed

8

SYS2008

BRE processing timed out

9

SYS2009

Dedupe system down

10

SYS2010

Dedupe processing failed

11

SYS2011

Dedupe processing timed out

12

SYS2012

Credit Bureau server down

13

SYS2013

Credit Bureau timed out

14

SYS2014

Any other ancillary system failure

AcceptOfferResponse

Sl No

Error Code

Description

1

AO8001

Selected offer no longer valid

SetDisbursementPlanResponse

Sl No

Error Code

Description

1

SDP1001

Selected disbursement plan no longer valid

SetRepaymentPlanResponse

Sl No

Error Code

Description

1

SRP1001

Selected repayment plan no longer valid

2

SYS9010

SYS9010

3

SYS9011

Invalid payment vpa

TriggerOTPResponse

Sl No

Error Code

Description

1

TOTP8001

Selected offer no longer valid

2

SYS8002

OTP Service Provider down

3

SYS8003

SYS8003

4

SYS8004

OTP Trigger failed

5

SYS8005

Too many OTP attempts

VerifyOTPResponse

Sl No

Error Code

Description

1

VOTP3001

OTP Session expired

2

VOTP3002

Invalid OTP

3

VOTP3003

Multiple incorrect attempts

GrantLoanResponse

Sl No

Error Code

Description

1

GLRS5001

Invalid vua

2

GLRS5002

Consent for fetching data from AA expired

3

GLRS5003

Selected offer no longer valid

4

GLRS5004

Selected disbursement plan not found

5

GLRS5005

Selected repayment plan not found

6

GLRS5006

Incomplete e-mandate details

7

SYS9001

LMS system down

8

SYS9002

LMS system timed out

TriggerDisbursementResponse & TriggerDisbursementStatusResponse

Sl No

Error Code

Description

1

TDRS5001

Invalid loan Id

2

SYS5002

CBS down

3

SYS5003

Disbursement failed

TriggerRepaymentResponse

Sl No

Error Code

Description

1

TRRS9001

Invalid loan Id

2

TRRS9002

No repayment method set for the request

TriggerRepaymentStatusResponse

Sl No

Error Code

Description

1

SYS8010

Insufficient Balance

2

SYS8011

Authorization failed

3

SYS8012

Authentication failure

4

SYS8013

Payment url expired

LoanSummaryResponse

Sl No

Error Code

Description

1

LSR6010

Invalid loan Id

LoanStatementResponse

Sl No

Error Code

Description

1

RHRS6001

RHRS6001

2

RHRS6002

Start Date before the loan start date

3

RHRS6003

End Date greater than current date

4

RHRS6004

Start date cannot be greater than end date

GetRepaymentPlansResponse

Sl No

Error Code

Description

1

GRPR6001

Invalid loan Id

2

GRPR6002

No Repayment Plans exist currently for this loan Id

GetDisbursementPlansResponse

Sl No

Error Code

Description

1

GDPR7001

Invalid loan Id

2

GDPR7002

No Disbursement Plans exist currently for this loan Id

RaiseDisputeRequest

Sl No

Error Code

Description

1

RDR8120

Invalid loan Id

UpdateDisputeRequest

Sl No

Error Code

Description

1

UDR8120

Invalid dispute Id


Did this page help you?