Create a Loan

This Quick Start Guide (QSG) shows you how to create a loan using the Loan Creation endpoints.

Before you start

You'll need to:

  • Request an API Key or renew an existing one. 
  • Have an API testing tool installed, for example Postman.
  • Have created a customer and current account.

To help you complete the procedure, use our Postman Collection or copy the drop-down code samples.

Procedure: How to Create a Loan

1. Open Postman.

2. Under Collections click temenos essential apis > transact > Lending > POST Create Personal Loan.

1. Select Create a Loan

3. Click the Body tab to view the payload. You can change details such as the amount, term and currency.

2. View body

Sample Code: Create a Loan Payload
{
  "header": {
    "override": {
      "overrideDetails": [
        {
          "description": "Maturity Date is not a Working Day",
          "id": "AA.MATURITY.DATE.NOT.WORKING.DAY",
          "type": "Override"
        },
        {
          "options": [
            "RECEIVED",
            "NOT RECEIVED"
          ],
          "description": "Have you received Loan Agreement/AAA*203 from 100336}RECEIVED_NOT RECEIVED",
          "id": "DM.CONFIRM.DOC",
          "type": "Warning",
          "responseCode": "RECEIVED"
        }
      ]
    }
  },
  "body": {
    "partyIds": [
      {
        "partyId": "100336"
      }
    ],
    "activityId": "LENDING-NEW-ARRANGEMENT",
    "arrangmentId": "NEW",
    "productId": "PERSONAL.LOAN",
    "commitment": {
      "amount": "25000",
      "term": "2Y"
    },
    "currency": "USD",
    "partyRoles": [
      {
        "partyRole": "OWNER"
      }
    ],
    "arrangementEffectiveDate": "20190417"
  }
}


4: Click Send.

200 OK Success message is displayed.

image 35

Sample Code: Create a Loan Response
{
    "header": {
        "transactionStatus": "Live",
        "audit": {
            "T24_time": 15904,
            "responseParse_time": 1,
            "requestParse_time": 1
        },
        "aaaId": "AAACT21105W5D4WX7P",
        "status": "success"
    },
    "body": {
        "arrangementActivity": {
            "activityId": "LENDING-NEW-ARRANGEMENT",
            "partyIds": [
                {
                    "partyId": "100336"
                }
            ],
            "arrangmentId": "AA21105Z206G",
            "productId": "PERSONAL.LOAN",
            "currency": "USD",
            "tradeDate": "20190417",
            "arrangementEffectiveDate": "20190417",
            "partyRoles": [
                {
                    "partyRole": "OWNER"
                }
            ]
        }
    }
}

A loan of $25,000 for two years is successfully created.