Skip to main content

Loan Action : Closure

1. Fetch Data for Closure

Upon fetching the SynoFin losure API. The user can choose the closure they must carry out in order to fulfil their demand at this point. 
Consequently, we use following API to retrieve the Data for the closure for the specified Loan Id.

POST Data For Loan Action

To obtain data for closure, utilise this API.

URL: {{base_url}}/loan-modification/v1/service-request/getDataForLoanActions

Request Type: POST
Authorization: Bearer Token

Query Parameter
No parameter

ForeClosure
Request Body 
{
    "request_id": "foreclosure",
    "loan_id": "134",
    "foreclosure_options": {
        "closure_date": "2024-10-08",
        "interest_till_date": "2024-10-08",
        "last_due_date": "2023-09-05",
        "closure_rate": "5",
        "total_waived_amount": [
            "0",
            "504",
            "2000",
            "0"
        ],
        "principal_waived": "2000"
    }
}
Response 
{
    "response": true,
    "data": {
        "balance_tenure": 0,
        "total_dues": 95411.11,
        "loan_service_charge_rate": 5.0,
        "loan_service_charge_amount": 1770.00,
        "refunds": 0.00,
        "principal_outstanding": 30000.00,
        "unrealized_receipt": 0.00,
        "outstanding_charges": [
            {
                "charge_id": 772,
                "charge_label": "Late Payment Penalty",
                "total_outstanding_amount": null,
                "type": "charges",
                "original_amount": 65641.11,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "lpp",
                "outstanding_amount": 65641.11,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            },
            {
                "charge_id": -2,
                "charge_label": "Total Interest Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -2,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 504.0,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            },
            {
                "charge_id": -3,
                "charge_label": "Total Principal Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -3,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 30000.0,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            },
            {
                "charge_id": 0,
                "charge_label": "Foreclosure charge",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "fore_closure_charge",
                "outstanding_amount": 1770.0,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            }
        ],
        "interest_due": 0.0,
        "pending_installment_amount": 30504.0,
        "total_waived_amount": 0.0,
        "per_day_interest": 0.0,
        "next_installment_presentation_date": null,
        "excess_money": 0.00,
        "net_closure_amount": 95411.11,
        "last_due_date": "05-09-2023",
        "overdue_principal": 0.0,
        "lockin_period": 0.0,
        "total_waiver_amount": 2504.0,
        "balance_principal": 0.0,
        "advance_installment": 0.00,
        "settled_amount": 28000.0,
        "write_off_amount": 2000.0
    },
    "error": null,
    "timestamp": "2024-10-08T14:20:17.459+00:00"
}

Maturity Closure
Request Body 
{
    "request_id": "maturity_closure",
    "loan_id": "134",
    "maturity_closure_options": {
        "closure_date": "2024-10-08",
        "interest_till_date": "2024-10-08",
        "last_due_date": "2023-09-05",
        "closure_rate": "0",
        "total_waived_amount": [
            "65641.11",
            "200",
            "500"
        ],
        "principal_waived": "500"
    }
}

 
Response 
{
    "response": true,
    "data": {
        "balance_tenure": 0,
        "total_dues": 29804.00,
        "refunds": 0.00,
        "principal_outstanding": 30000.00,
        "unrealized_receipt": 0.00,
        "outstanding_charges": [
            {
                "charge_id": 772,
                "charge_label": "Late Payment Penalty",
                "total_outstanding_amount": null,
                "type": "charges",
                "original_amount": 65641.11,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "lpp",
                "outstanding_amount": 65641.11,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            },
            {
                "charge_id": -2,
                "charge_label": "Total Interest Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -2,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 504.0,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            },
            {
                "charge_id": -3,
                "charge_label": "Total Principal Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -3,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 30000.0,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null
            }
        ],
        "interest_due": 0.0,
        "pending_installment_amount": 30504.0,
        "total_waived_amount": 0.0,
        "per_day_interest": 0.0,
        "next_installment_presentation_date": null,
        "excess_money": 0.00,
        "net_closure_amount": 29804.00,
        "last_due_date": "05-09-2023",
        "overdue_principal": 0.0,
        "balance_principal": 0.0,
        "settled_amount": 29500.0,
        "write_off_amount": 500.0
    },
    "error": null,
    "timestamp": "2024-10-08T14:28:40.014+00:00"
}

2. Saving / Initiation Request for Loan Action (Closure)

These are the APIs that are used to save loan closure or initiate service requests initiated by maker so that the checker can review them and then determine what they want to accomplish and either Approve or Reject the Request.

Consequently, we use following APIs to save or intiated the Loan Closure for the selected closure for the specified Loan Id.

POST Save Service Request

To save data for Cancellation, utilise this API.

URL: {{base_url}}/loan-modification/v1/service-request/save

Request Type: POST
Authorization: Bearer Token

Query Parameter
No parameter

Loan Actions - Closure

Request Body

Response: 200

Fore Closure

 
{
    "service_request_type": "foreclosure",
    "service_request_subtype": "2",
    "service_type": "",
    "loan_id": "134",
    "request_data": {
        "balance_tenure": "0",
        "total_dues": 32074,
        "unrealized_receipt": "0",
        "last_due_date": "05-09-2023",
        "closure_date": "2024-10-08",
        "interest_till_date": "2024-10-08",
        "loan_service_charge_rate": 5,
        "loan_service_charge_amount": 1770,
        "refunds": 0,
        "interest_due": 0,
        "balance_principal": "0",
        "principal_outstanding": 30000,
        "excess_money": "0",
        "advance_installment": "0",
        "per_day_interest": 0,
        "net_closure_amount": 32074,
        "lockin_period": 0,
        "reason": "1504",
        "closure_type": "",
        "waiver_users": "",
        "uploadFile": "",
        "total_waiver_amount": 65841.11,
        "is_write_off": false,
        "write_off_amount": 0,
        "settled_amount": 30000,
        "outstanding_charges": [
            {
                "charge_id": 772,
                "charge_label": "Late Payment Penalty",
                "total_outstanding_amount": null,
                "type": "charges",
                "original_amount": 65641.11,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "lpp",
                "outstanding_amount": 65641.11,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "65641.11",
                "waiver_users": ""
            },
            {
                "charge_id": -2,
                "charge_label": "Total Interest Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -2,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 504,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "200",
                "waiver_users": ""
            },
            {
                "charge_id": -3,
                "charge_label": "Total Principal Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -3,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 30000,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "0",
                "waiver_users": ""
            },
            {
                "charge_id": 0,
                "charge_label": "Foreclosure charge",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "fore_closure_charge",
                "outstanding_amount": 1770,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "0",
                "waiver_users": ""
            }
        ],
        "remarks": "",
        "payment_on_hold_reason": "",
        "other_reason": "",
        "total_waived_amount": 0,
        "transaction_date": "2024-10-08"
    },
    "service_request_id": ""
}
 
{
    "response": true,
    "data": {
        "result": null,
        "status": "initiated",
        "service_request_id": 0,
        "unique_transaction_number": null
    },
    "error": null
}

Maturity Closure

 
{
    "service_request_type": "maturity_closure",
    "service_request_subtype": "2",
    "service_type": "",
    "loan_id": "134",
    "request_data": {
        "balance_tenure": "0",
        "total_dues": 96145.11,
        "unrealized_receipt": "0",
        "last_due_date": "05-09-2023",
        "closure_date": "2024-10-08",
        "interest_till_date": "2024-10-08",
        "refunds": "0",
        "balance_principal": "0",
        "principal_outstanding": 30000,
        "excess_money": "0",
        "per_day_interest": "0",
        "interest_due": "0",
        "net_closure_amount": 96145.11,
        "reason": "1403",
        "upload_file": "",
        "waiver_users": "",
        "is_write_off": "",
        "write_off_amount": "0",
        "settled_amount": "0",
        "outstanding_charges": [
            {
                "charge_id": 772,
                "charge_label": "Late Payment Penalty",
                "total_outstanding_amount": null,
                "type": "charges",
                "original_amount": 65641.11,
                "charge_definition_id": null,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": "lpp",
                "outstanding_amount": 65641.11,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "0",
                "waiver_users": ""
            },
            {
                "charge_id": -2,
                "charge_label": "Total Interest Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -2,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 504,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "0",
                "waiver_users": ""
            },
            {
                "charge_id": -3,
                "charge_label": "Total Principal Outstanding",
                "total_outstanding_amount": null,
                "type": null,
                "original_amount": null,
                "charge_definition_id": -3,
                "excess_money_id": null,
                "loan_id": null,
                "disbursal_schedule_id": null,
                "charge_code": null,
                "outstanding_amount": 30000,
                "amount_in_process": null,
                "payment_status": null,
                "paid_amount": null,
                "total_paid_amount": null,
                "total_paid_amount_in_process": null,
                "paid_amount_in_process": null,
                "allocated_amount": null,
                "reason": null,
                "payment_date": null,
                "repayment_id": null,
                "balance_payable": null,
                "waiver": "0",
                "waiver_users": ""
            }
        ],
        "remarks": "",
        "payment_on_hold_reason": "",
        "other_reason": "",
        "transaction_date": "2024-10-08"
    },
    "service_request_id": ""
}
 
{
    "response": true,
    "data": {
        "result": null,
        "status": "initiated",
        "service_request_id": 0,
        "unique_transaction_number": null
    },
    "error": null
}


Request Approval / Rejection 

The request must now be approved at the Request page, where users may examine requests and take action.

SynoFin - Request

No Comments
Back to top