To change a loan status by passing in reference numbers of verification API calls
The loan will be pushed to further statuses i.e from open to kyc_approved to credit_approved, etc automatically. If all the parameters are provided then the loan will be pushed to the disbursal approved status after checking that all the parameters are correct.
There are cases when you want to verify a user using a number of verifications, and then associate a kudos_loan_id to the user. In this case Kudos can move a borrower to the appropriate loan status such as credit_approved, disbursal_approved as long as we have the reference number of the verifications which were done at an earlier time.
This endpoint takes in these reference id's as headers and moves the kudos_loan_id to the appropriate state.
In case no headers are passed in - then it returns the current loan state.
In case your credit limit customers are not in disbursal_approved by default
Calling this API is mandatory before setting the credit limit
Unique Loan status with their description is as below:
| Status | Description |
|---|---|
| open | When a new loan is booked, it arrives in Open status. |
| credit_approved | Once a loan meets the product credit criteria, the status is moved to credit_approved |
| disbursal_approved | Once a loan is credit_approved, Ops team checks the KYC and loan data and ensures it's correct. If all details are mentioned correctly, the loan is moved to disbursal approved stage which means that the loan is ready for disbursal |
| Issue_reported | If any discrepancies are found in the loan, the case is moved to Issue reported stage , which allows the partner to make the required changes |
| rejected | If the customer does not fit the criteria, the loan is rejected |
| disbursed | When a loan is successfully disbursed and amount is sent to customer account |
| closed | If all expected repayments are received for the particular loan, the loan status changes to closed |
NOTE
- All the mandatory documents need to be uploaded using the loan document API
- If loan status is open then ckyc_kyc_id or pan_kyc_id and aadhar_kyc_id are required.
- If loan status is kyc_approved then bureau_id are required
- If loan status is credit approved then pennydrop_id is required.