Skip to main content

Cancellation

Loan Action - Cancellation

The Synofin API's Loan Cancellation Action is linked to various cancellations that a user may initiate in accordance with their requirements.

Screenshot 2023-04-21 at 10.33.46 AM.png

GET Cancellation

This API is used for retrieving all the cancellation details for the specified Loan Id. 

URL: {{base_url}}/loan-management/v1/service-request/status

Request
Request Type: GET
Authorization: Bearer Token
Query Parameter
Key Data Type Value
request* String Fixed = cancellation
loanId* Integer -
* required Param

Response: 200

{
    "response": true,
    "data": true,
    "error": null
}



Fetch Charges and Data for Cancellation

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

     
  1. POST
    Data For Loan Action

    To obtain data for Cancellation, utilise this API.

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

    Request Type: POST
    Authorization: Bearer Token

    Query Parameter
    No parameter
  2. Loan Actions - Cancellation

    Request Body

    Response: 200

    Loan Cancellation

    {
        "loan_id": "integer",
        "request_id": "loan_cancellation"
    }

    {
       "response": true,
       "data": {
          "total_dues": 0,
          "net_dues": 0,
          "net_refund": 0
       },
       "error": null
    }


    Receipt Cancellation

    {
        "loan_id": "integer",
        "request_id": "receipt_cancellation"
    }

    {
       "response": true,
       "data": {
          "receipt_cancellation": [],
          "receipt_cancellation_date": "yyyy-MM-dd"
       },
       "error": null
    }

    Payment Cancellation

    {
        "loan_id": "1455",
        "request_id": "payment_cancellation"
    }

    {
       "response": true,
       "data": {
          "payment_cancellation": [],
          "payment_cancellation_date": "yyyy-MM-dd"
       },
       "error": null
    }

    Rescheduling

    Cancellation

    {
        "loan_id": "1455",
        "request_id": "rescheduling_cancellation"
    }

    {
      "response": true,
      "data": {
        "rescheduling_cancellation": [],
        "rescheduling_cancellation_date": "yyyy-MM-dd"
      },
      "error": null
    }

    Adhoc Cancellation

    {
        "charges": [
            {
                "loan_charge_id": 0,
                "transaction_date": "14/02/2024",
                "due_date": "14/02/2024",
                "type": "string",
                "charge_name": "string Money",
                "charge_code": "string",
                "original_amount": 0,
                "paid_amount": 0,
                "waiver_amount": 0,
                "amount_in_process": 0,
                "charge_state": "0",
                "source": "string",
                "payment_status": "string"
            }
        ]
    }

    {
        "response": true,
        "data": {
            "charges": [
                {
                    "loan_charge_id": 0,
                    "transaction_date": "14/02/2024",
                    "due_date": "14/02/2024",
                    "type": "string",
                    "charge_name": "string",
                    "charge_code": "string",
                    "original_amount": 0,
                    "paid_amount": 0.0,
                    "waiver_amount": 0.0,
                    "amount_in_process": 0.0,
                    "charge_state": "string",
                    "source": "string",
                    "payment_status": "string"
                }
            ]
        },
        "error": null
    }

    Foreclosure Cancellation

    {
        "foreclosure_service_request": null,
        "foreclosure_charge": null,
        "foreclosure_cancellation_date": "yyyy-MM-dd"
    }

    {
        "response": true,
        "data": {
            "foreclosure_service_request": null,
            "foreclosure_charge": null,
            "foreclosure_cancellation_date": "yyyy-MM-dd"
        },
        "error": null
    }

    Response: 200

{
   "response": true,
   "data": {
      "outstanding_charges": [ ],
      "date_of_receipt": "yyyy-MM-dd",
      "addition_in_excess_money": integer
   },
   "error": null
}

 

Loan Action - Cancellation Get  



Saving / Creating Request for Loan Cancellation

These are the APIs that are used to save loan cancellations 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 Cancellation for the selected cancellation for the specified Loan Id.

  1. Loan Cancellation
  2. Receipt Cancellation
  3. Payment Cancellation
  4. Rescheduling Cancellation
  5. Adhoc Cancellation
  6. Foreclosure Cancellation