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": ""
        }
    }
}