Skip to main content

Loan Action : Receipt

Receipt

Screenshot 2023-04-22 at 4.49.03 AM.png

The Synofin API's Loan Receipt Action is linked to various closure that a user may initiate in accordance with their requirements. This feature involves different step which are :

  1. Retrieving Cancellation (Receipt)
  2. Retrieving Data for Loan Action (Receipt)
  3. Saving / Initiation Request for Loan Action (Receipt)
  4. Approving / Rejection Service Request for Loan Action (Receipt)




GET Receipt

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

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

Request
Request Type: GET
Authorization: Bearer Token
Query Parameter
KeyData TypeValue
request*StringFixed = receipt
loanId*Integer-
* required Param

Response: 200

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



Fetch Data for Receipt

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

  1. Data for Loan Action Receipt
  2. Master data for Receipt

POST Data For Loan Action

To obtain data for Receipt, utilise this API.

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

Request Type: POST
Authorization: Bearer Token

Query Parameter
No parameter

Loan Actions - Receipt

Request Body

Response: 200

Receipt

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

{
   "response": true,
   "data": {
      "outstanding_charges": [],
      "date_of_receipt": "2024-02-14",
      "addition_in_excess_money": 0
   },
   "error": null
}


Cheque Deposit

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

{
    "response": true,
    "data": {
        "deposit_receipts": []
    },
    "error": null
}

Receipt Realization / Bounce

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

{
   "response": true,
   "data": {
      "receipt_realize": [],
      "realization_date": "2024-02-14"
   },
   "error": null
}

Receipt Transfer

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

{
    "response": true,
    "data": {
        "receipt_transfer": [],
        "receipt_transfer_date": "2024-02-14"
    },
    "error": null
}

Receipt Bank Reconciliation

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

{
   "response": true,
   "data": {
      "receipt_bank_reconciliation": []
   },
   "error": null
}


POST Master Data for Receipt

To obtain Master data for Receipt, utilise this API.

URL: {{base_url}}/loan-management/v1/getMasterType

Request Type: POST
Authorization: Bearer Token

Query Parameter
No parameter

Loan Actions - Receipt

Request -

Request Body

Response: 200

Receipt

[
    {
        "type": "payment_mode"
    },
    {
        "type": "receipt_purpose"
    },
    {
        "type": "payment_bank"
    },
    {
        "type": "bounce_reason_for_nach"
    }
]

{
   "response": true,
   "data": [
      {
         "payment_mode": {},
         "receipt_purpose": {},
         "bounce_reason_for_nach": {},
         "payment_bank": {}
      }
   ],
   "error": null
}


Cheque Deposit

[
    {
        "type": "payment_bank"
    }
]

{
   "response": true,
   "data": [
      {
         "payment_bank": {}
      }
   ],
   "error": null
}

Receipt Realization / Bounce

[
    {
        "type": "bounce_reason_for_cheque"
    }
]

{
    "response": true,
    "data": [
        {
            "bounce_reason_for_cheque": {}
        }
    ],
    "error": null
}

Receipt Transfer

[]

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

Receipt Bank Reconciliation

[]

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



Saving / Initiation Request for Loan Action (Receipt)

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

POST Save Service Request

To save data for Receipt, utilise this API.

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

Request Type: POST
Authorization: Bearer Token

Query Parameter
No parameter

Loan Actions - Receipt

Request Body

Response: 200

Receipt

{
   "service_request_type": "receipt",
   "service_request_subtype": "0",
   "service_type": "",
   "loan_id": "0",
   "request_data": {
      "date_of_receipt": "2024-02-14",
      "receipt_amount": "0",
      "cash_receipt_number": "",
      "payment_mode": "string",
      "transaction_date": "2024-02-14",
      "received_from": "string",
      "receipt_purpose": "string",
      "instrument_date": "2024-02-14",
      "instrument_number": "",
      "transaction_reference": "",
      "payment_bank": "",
      "upi": "",
      "instrument_bank_name": "",
      "bank_account_number": "",
      "fund_transfer_number": "",
      "ifsc": "",
      "instrument_bank_address": "",
      "is_nach": true,
      "bounce_reason_for_nach": "",
      "addition_in_excess_money": "0",
      "bank_recon_ref_identifier": "",
      "auto_allocated": "Yes",
      "receipts_allocation": "",
      "remarks": "",
      "receivables": []
   },
   "service_request_id": ""
}

{
    "response": true,
    "data": {
        "result": null,
        "service_request_id": 0
    },
    "error": null
}


Cheque Deposit

{}

{
    "response": true,
    "data": {
        "result": null,
        "service_request_id": 0
    },
    "error": null
}

Receipt Realization / Bounce

{
   "service_request_type": "receipt_bounce",
   "service_request_subtype": "0",
   "service_type": "",
   "loan_id": "0",
   "request_data": {
      "total_instruments": 0,
      "total_amount": 0,
      "realization_date": "2024-02-14",
      "bounce_reason_for_cheque": "string",
      "receipt_realize": [
         {
            "receipt_reference": "string",
            "fund_transfer_receipt": "0",
            "receipt_amount": 0,
            "bounce_reason": null,
            "charge_id": null,
            "instrument_number": "0",
            "pay_slip_number": null,
            "source_id": null,
            "receipt_purpose": "string",
            "receipt_id": null,
            "deposit_bank_acc_number": "string",
            "reason_code": null,
            "reason_description": null,
            "loan_account": "string",
            "receipt_payment_type": null,
            "date_of_receipt": "14/02/2024",
            "repayment_indicator": null,
            "receipt_status": "string",
            "payment_type": "string",
            "transaction_date": "14/02/2024",
            "service_request_id": 0,
            "receipt_state": "string",
            "receipts_breakup": null,
            "deposit_date": "14/02/2024",
            "instrument_date": "14/02/2024",
            "bank_reconciliation_reference_identifier": null
         }
      ],
      "remarks": "",
      "transaction_date": "2024-02-14"
   },
   "service_request_id": ""
}

{
    "response": true,
    "data": {
        "result": null,
        "service_request_id": 0
    },
    "error": null
}

Receipt Transfer

{
   "service_request_type": "receipt_transfer",
   "service_request_subtype": "0",
   "service_type": "",
   "loan_id": "0",
   "request_data": {
      "receipt_transfer": [
         {
            "receipt_reference": "string",
            "fund_transfer_receipt": "string",
            "receipt_amount": 0,
            "bounce_reason": null,
            "charge_id": null,
            "instrument_number": "",
            "pay_slip_number": null,
            "source_id": null,
            "receipt_purpose": "string",
            "receipt_id": null,
            "deposit_bank_acc_number": null,
            "reason_code": null,
            "reason_description": null,
            "loan_account": "string",
            "receipt_payment_type": null,
            "date_of_receipt": "30/01/2024",
            "repayment_indicator": null,
            "receipt_status": "string",
            "payment_type": "string",
            "transaction_date": "30/01/2024",
            "service_request_id": 0,
            "receipt_state": "string",
            "receipts_breakup": null,
            "deposit_date": "30/01/2024",
            "instrument_date": "30/01/2024",
            "bank_reconciliation_reference_identifier": null
         }
      ],
      "receipt_transfer_date": "2024-02-14",
      "loan_application_number": "0",
      "transaction_date": "2024-02-14"
   },
   "service_request_id": ""
}

{
    "response": true,
    "data": {
        "result": null,
        "service_request_id": 0
    },
    "error": null
}

Receipt Bank Reconciliation

{
   "service_request_type": "receipt_bank_reconciliation",
   "service_request_subtype": "0",
   "service_type": "",
   "loan_id": "0",
   "request_data": {
      "receipt_bank_reconciliation": [
         {
            "receipt_reference": "string",
            "fund_transfer_receipt": null,
            "receipt_amount": null,
            "bounce_reason": null,
            "charge_id": null,
            "instrument_number": null,
            "pay_slip_number": null,
            "source_id": null,
            "receipt_purpose": null,
            "receipt_id": 0,
            "deposit_bank_acc_number": null,
            "reason_code": null,
            "reason_description": null,
            "loan_account": "string",
            "receipt_payment_type": null,
            "date_of_receipt": "2024-02-14 00:00:00.0",
            "repayment_indicator": null,
            "receipt_status": "string",
            "payment_type": "string",
            "transaction_date": null,
            "service_request_id": null,
            "receipt_state": "string",
            "receipts_breakup": null,
            "deposit_date": "2024-02-14 00:00:00.0",
            "instrument_date": null,
            "bank_reconciliation_reference_identifier": ""
         }
      ],
      "bank_recon_ref_identifier": "",
      "transaction_date": "2024-02-14"
   },
   "service_request_id": ""
}

{
    "response": true,
    "data": {
        "result": null,
        "service_request_id": 0
    },
    "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