Developer Portal

신용대출 금리한도조회(개인)

신용대출 금리한도조회

API 명 (URI)	/api/v1/loan/inquiry
Method	POST
Content-Type	application/json; charset=UTF-8

개인 신용대출의 금리 및 한도를 조회합니다.

API 명 (URI)	/api/v1/loan/inquiry
Method	POST
Content-Type	application/json; charset=UTF-8

개인 신용대출의 금리 및 한도를 조회합니다.

요청 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증("Bearer"+token)	Y	Field	String	400
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4
Body	srvcDscd	서비스구분코드		Field	String	1
Body	CustNm	고객명	Y	Field	String	152
Body	custSsNbr	주민등록번호	Y	Field	String	24
Body	bsnnNbr	사업자번호		Field	String	10
Body	ofcNm	직장명		Field	String	100
Body	SelfAuthMthdCd	본인인증방법코드		Field	String	1
Body	crcnClphnNbr	신용상담본인인증일시	Y	Field	String	14
Body	cmacDsCd	통신사구분코드	Y	Field	String	1
Body	CildNbr	CI	Y	Field	String	128
Body	OcptnDcd	직업구분코드	Y	Field	String	1
Body	aincmAmt	연소득금액	Y	Field	Number	15
Body	ofcHiredMnth	입사년월일		Field	String	8
Body	filler	예비필드		Field	String	200
Body	StplCnt	약관동의건수	Y	Field	Number	2
Body	StplCd	약관코드	Y	Field	String	2
Body	StplAgrmDttm	약관동의일시	Y	Field	String	14
Body	StplAgrmYn	약관동의여부	Y	Field	String	1
Body	crcnReqPdCnt	신용상담요청상품건수	Y	Field	Number	2
Body	crcnAlcoRcptNbr	제휴사신청번호	Y	Field	String	14
Body	crcnAlcoPdId	제휴사상품코드	Y	Field	String	16
Body	FinInstCd	보유기관금융회사코드		Field	String	3
Body	SubInstCd	하위보유기관코드		Field	String	3
Body	Industry	업권		Field	String	20
Body	RpayId	대환대출ID		Field	String	30
Body	AcctNo	대출계좌번호	Y	Field	String	64
Body	LoPrdTp	대출상품종류		Field	String	4
Body	LoPrdNm	대출상품명		Field	String	50
Body	LoExDt	대출일자		Field	String	8
Body	LoAmt	대출원금		Field	Number	15
Body	RpayAmt	상환총액		Field	Number	15
Body	BalanceAmt	대출잔액		Field	Number	15
Body	IntAmtSn	이자금액부호		Field	String	1
Body	IntAmt	이자금액		Field	Number	15
Body	RpayChg	중도상환수수료		Field	Number	15
Body	LstIntRt	최종적용금리		Field	String	7
Body	ExpDt	만기일자		Field	String	8
Body	NxtRpayDt	다음이자상환일		Field	String	8
Body	RpayTp	상환방식		Field	String	2
Body	RpayTeM	상환개월수		Field	String	3
Body	RpayDt	월상환일		Field	String	8
Body	RpayBlank	예비필드		Field	String	50
Body	scrpInfoUseYn	건강보험 스크래핑정보	Y	Field	String	1
Body	HlthInsrMbrDcd	건강보험가입자구분코드		Field	String	1
Body	OFC_NM	직장명		Field	String	100
Body	qlfcAcqstnDt	자격취득년월일		Field	String	8
Body	filler	에비필드		Field	String	200
Body	hlthInsrPymntCnt	건강보험납부건수	Y	Field	Number	2
Body	healthPremiumPymntYrMnth	건강보험료납부년월		Field	String	6
Body	ofcNtfHealthPremium	직장고지건강보험료		Field	Number	15
Body	ofcPymntHealthPremium	직장납부건강보험료		Field	Number	15

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증("Bearer"+token)	Y	Field	String	400
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4
Body	srvcDscd	서비스구분코드		Field	String	1
Body	CustNm	고객명	Y	Field	String	152
Body	custSsNbr	주민등록번호	Y	Field	String	24
Body	bsnnNbr	사업자번호		Field	String	10
Body	ofcNm	직장명		Field	String	100
Body	SelfAuthMthdCd	본인인증방법코드		Field	String	1
Body	crcnClphnNbr	신용상담본인인증일시	Y	Field	String	14
Body	cmacDsCd	통신사구분코드	Y	Field	String	1
Body	CildNbr	CI	Y	Field	String	128
Body	OcptnDcd	직업구분코드	Y	Field	String	1
Body	aincmAmt	연소득금액	Y	Field	Number	15
Body	ofcHiredMnth	입사년월일		Field	String	8
Body	filler	예비필드		Field	String	200
Body	StplCnt	약관동의건수	Y	Field	Number	2
Body	StplCd	약관코드	Y	Field	String	2
Body	StplAgrmDttm	약관동의일시	Y	Field	String	14
Body	StplAgrmYn	약관동의여부	Y	Field	String	1
Body	crcnReqPdCnt	신용상담요청상품건수	Y	Field	Number	2
Body	crcnAlcoRcptNbr	제휴사신청번호	Y	Field	String	14
Body	crcnAlcoPdId	제휴사상품코드	Y	Field	String	16
Body	FinInstCd	보유기관금융회사코드		Field	String	3
Body	SubInstCd	하위보유기관코드		Field	String	3
Body	Industry	업권		Field	String	20
Body	RpayId	대환대출ID		Field	String	30
Body	AcctNo	대출계좌번호	Y	Field	String	64
Body	LoPrdTp	대출상품종류		Field	String	4
Body	LoPrdNm	대출상품명		Field	String	50
Body	LoExDt	대출일자		Field	String	8
Body	LoAmt	대출원금		Field	Number	15
Body	RpayAmt	상환총액		Field	Number	15
Body	BalanceAmt	대출잔액		Field	Number	15
Body	IntAmtSn	이자금액부호		Field	String	1
Body	IntAmt	이자금액		Field	Number	15
Body	RpayChg	중도상환수수료		Field	Number	15
Body	LstIntRt	최종적용금리		Field	String	7
Body	ExpDt	만기일자		Field	String	8
Body	NxtRpayDt	다음이자상환일		Field	String	8
Body	RpayTp	상환방식		Field	String	2
Body	RpayTeM	상환개월수		Field	String	3
Body	RpayDt	월상환일		Field	String	8
Body	RpayBlank	예비필드		Field	String	50
Body	scrpInfoUseYn	건강보험 스크래핑정보	Y	Field	String	1
Body	HlthInsrMbrDcd	건강보험가입자구분코드		Field	String	1
Body	OFC_NM	직장명		Field	String	100
Body	qlfcAcqstnDt	자격취득년월일		Field	String	8
Body	filler	에비필드		Field	String	200
Body	hlthInsrPymntCnt	건강보험납부건수	Y	Field	Number	2
Body	healthPremiumPymntYrMnth	건강보험료납부년월		Field	String	6
Body	ofcNtfHealthPremium	직장고지건강보험료		Field	Number	15
Body	ofcPymntHealthPremium	직장납부건강보험료		Field	Number	15

요청 메시지 예제

Header

Content-Type: application/json

Body

{ "dataCmn": { "fnclInstCd":"KBK", "alncInstCd":"JHC", "tlgrRspnsCd":"" }, "srvcDsCd": "1", "CustNm": "강감찬", "custSsNbr": "0101243937810", "bsnnNbr": "", "ofcNm": "주식회사 고구려", "SelfAuthMthdCd": "3", "crcnSelfAuthDttm": "20241213014600", "crcnClphnNbr": "01033334444", "cmacDsCd": "3", "CilsNbr": "KBANK==000000020001740KBANK==000000020001740KBANK==000000020001740KBANK==000000020001740", "OcptnDcd": "1", "aincmAmt": 127000000, "ofcHiredMnth": "20221027", "filler": "", "StplCnt": 4, "StplCd": "01", "StplAgrmDttm": "20241213015710", "StplAgrmYn": "Y", "crcnReqPdCnt": 1, "crcnAlcoPdId": "P210001001", "FinInstCd": "081", "SubInstCd": "", "Industry": "15", "RpayId": "", "AcctNo": "100152318420", "LoPrdTp": "1111", "LoPrdNm": "신용대출", "LoExDt": "", "RpayAmt": 0, "BalanceAmt": 0, "IntAmtSn": "+", "IntAmt": 0, "RpayChg": 0, "LstIntRt": 0, "ExDt": "", "NxRpayDt": "", "RpayTp": "", "RpayBlank": 0, "scrpInfoUseYn": "Y", "HlthInsrMbrDcd": "1", "OFC_NM": "", "qlfcAcqstnDt": "", "filler": "", "hlthInsrPymntCnt": 24, "healthPremiumPymntYrMnth": "", "ofcNtfHealthPremium": 0, "ofcPymntHealthPremium": 0 }

응답 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	dataCmn	공통부		Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnsCd	응답코드	Y	Field	String	4

*대출금리한도조회결과 별도통지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	dataCmn	공통부		Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnsCd	응답코드	Y	Field	String	4

*대출금리한도조회결과 별도통지

응답 메시지 예제

Body

{ "dataCmn": { "fnclInstCd":"KBK", "alncInstCd":"JHC", "tlgrRspnsCd":"0000" } }

테스트

API 이용 신청

kbank

API 상세보기

Kbank

신용대출 금리한도조회(개인)

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

신용대출 금리한도조회(개인)

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

알림

알림

알림