Loan Calculator

This API calculates the cost rate of our bank's loan product based on input information. It also creates a detailed payment plan.

API Information

URL

/loanCalculator

Method

POST

Version

1.0

Scope

Information Services

Authorization Flow

Client Credentials


Input Information

Name Format Description Required/Optional

LoanProductId

String Loan product id Zorunlu

LoanPeriod

Number Loan period Zorunlu

LoanAmount

Decimal Loan amount Zorunlu

GracePeriod

Number Grace period Zorunlu

InstallmentPeriod

Number Installment period Zorunlu


Output Information

Name Format Description

KKDF

Decimal Resource usage support fund

ExpertisePrice

Decimal Expertise price

LoanProductId

String Loan product id

LoanAllocationPrice

Decimal Loan allocation price

BSMV

Decimal Bank insurance tax

YearlyCostRate

Decimal Yearly cost rate

InstallmentAmount

Decimal Installment amount

TotalAmount

Decimal Total amount

LoanPeriod

Number Loan period

LoanAmount

Decimal Loan amount

GracePeriod

Number Grace period

InstallmentPeriod

Number Installment period

InterestRate

Decimal Interest rate

PaymentPlan

List<PaymentPlan> Payment plan


PaymentPlan

Alan Adı Format Açıklama

PrincipalBalance

Decimal Principal balance

KKDF

Decimal Resource usage support fund

InstallmentInterest

Decimal Installment interest

InstallmentPrincipal

Decimal Installment principal

BSMV

Decimal Bank insurance tax

InstallmentAmount

Decimal Installment amount

Date

yyyy-MM-ddTHH24:mm:ss Expiry date

Example

Request:

{
    "LoanProductId": "35009",
    "LoanPeriod": 12,
    "LoanAmount": 10000,
    "GracePeriod": 0,
    "InstallmentPeriod": 1
}

Response:

 {
    "Status": {
        "Code": "APIGW000000",
        "Description": "Success",
        "ObjectID": "9b8abb00-457f-4433-9179-a103fedafa26"
    },
    "Data": {
        "KKDF": "15.0",
        "ExpertisePrice": "",
        "LoanProductId":"35009",        
        "LoanAllocationPrice": "25.0",
        "BSMV": "5.0",
        "YearlyCostRate": "45.3925",
        "InstallmentAmount": "1014.73",
        "TotalAmount": "10000.0",
        "LoanPeriod": "12",
        "LoanAmount": "10000.0",
        "PaymentPlan": [
            {
                "PrincipalBalance": "10000.0",
                "KKDF": "",
                "InstallmentInterest": "",
                "InstallmentPrincipal": "",
                "BSMV": "",
                "InstallmentAmount": "",
                "Date": "2020-02-17T14:51:32.5542469"
            },
            {
                "PrincipalBalance": "9302.07",
                "KKDF": "39.6",
                "InstallmentInterest": "",
                "InstallmentPrincipal": "697.93",
                "BSMV": "13.2",
                "InstallmentAmount": "",
                "Date": "2020-03-17T00:00:00"
            },
           …
        ],
        "GracePeriod": "",
        "InstallmentPeriod": "1",
        "InterestRate": "2.64"
    }
}