Personal Loan Application

Personal loan is applied using this API.

API Information

URL

 /personalLoanApplication

Method

 POST

Version

 1.0

Scope

 loan

Authorization Flow

 Client Credentials


Input Information

Name Format Description Required/Optional

IdentityNumber

 String (11) Customer T.R. identity number Required

PhoneNumber

 String (11) Customer cell phone number Required

LoanAmount

 Number (26,2) Loan amount
Amount range 1000-9000 TRY 		Required

LoanTerm

 Number (3) Loan term
Term range 3 – 36 Month		 Required

MonthlyIncome

Number (26,2) Customer income (Montly) Required

EmploymentStatus

 Number (1) Customer employment status
1: Employed 2: Not Employed 3: Retired Employed 4: Retired Not Employed 		Required

ResidenceType

 Number (2) Customer residence type
1:Family Estate 2: Share Ownership 3: Rental 4:Lodging 5: Own Property 6: Common Property		 Required

Sector

 Number (1) Customer industry which work in Optional

ProfessionCode

 Number (3) Customer profession code Optional

EducationLevel

 Number (2) Customer education level code Optional

TitleCode

 Number (2) Customer title code Optional


Output Information

ApplicationResult

Name Format Description

StatusCode

 Number Status code

StatusDescription

 String Status description

AssessmentStatusCode

 Number Assesment status code

AssessmentStatusDescription

 String Assesment status description

FailedStatusCode

 Number Failed status code

FailedStatusDescription

 String Failed status description

ApplicationNumber

 String Application number

IdentityNumber

 Number Customer T.R. identity number

PhoneNumber

 Number Customer cell phone number

LoanAmount

 Number Loan amount

LoanTerm

 Number Loan term

MonthlyIncome

Number Customer income (monthly)

EmploymentStatus

 Number Customer employment status

Sector

 Number Customer industry which work in

ProfessionCode

 Number Customer profession code

EducationLevel

 Number Customer education level

ResidenceType

 Number Customer education level

LoanFee

 Number Loan fee

InterestRate

 Number Interest rate

InsurancePremiumAmount

 Number Insurance premium amount

FirstInstallmentDate

 Datetime First installment date

TitleCode

 Number Customer title code


Message Codes

Message Code Description

ACBH000101

 T.R. Identity Number cannot be empty.

ACBH000106

 Phone number cannot be empty.

ACBH000146

 T.R. Identity Number should be proper format.

ACBH000147

 Phone number should be proper format.

ACBH000156

 Employment status is invalid.

ACBH000157

 Sector is invalid.

ACBH000158

 Profession code is invalid.

ACBH000159

 Education level is invalid.

ACBH000160

 Residence type is invalid.

ACBH000172

 Title code is invalid.

Example

Request:

{
	"IdentityNumber": "" ,    
	"PhoneNumber": "",    
	"LoanAmount": 10000,    
	"LoanTerm": 36,      
	"MonthlyIncome": 5000,      
	"EmploymentStatus": 1,    
	"Sector": 2,    
	"ProfessionCode": 14,    
	"EducationLevel": 6,    
	"ResidenceType": 1,
	"TitleCode": 1
}

Response:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Completed",
        "ObjectID": "4addf5a2-9868-4a36-a10d-aadd017e45af"
    },
    "Data": {
        "ApplicationResult": {
            "Sector": "2",
            "EmploymentStatus": "1",
            "InterestRate": "2.19",
            "EducationLevel": "6",
            "StatusCode": "1",
            "InsurancePremiumAmount": "68.75",
            "AssessmentStatusCode": "1",
            "AssessmentStatusDescription": "Olumlu",
            "LoanAmount": "5000.0",
            "ResidenceType": "1",
            "LoanTerm": "36",
            "StatusDescription": "Başarılı",
            "TitleCode": "1",
            "ApplicationNumber": "87406927",
            "PhoneNumber": "",
            "ProfessionCode": "14",
            "LoanFee": "",
            "FailedStatusDescription": "",
            "FailedStatusCode": "",
            "MonthlyIncome": "5000.0",
            "FirstInstallmentDate": "2020-12-04T00:00:00",
            "IdentityNumber": ""
        }
    }
}