개발자 문서/은행코드 조회

은행코드 조회

명세 내보내기OpenAPI 3.0.3Postman 컬렉션Markdown

은행별 금융결제원 공식 코드번호를 조회합니다.

POST/rest/bank_code
요청 예제로 이동 ↓

기능·제공 범위

인증
Bearer 키
요청
form-data
응답
JSON

빠른 시작

서버의 APICK_API_KEY를 준비하고 입력값을 바꾸세요. 아래에서 경로별 입력·응답·실행 환경을 함께 확인할 수 있습니다.

요청과 응답

API 요청
POST/rest/bank_code

Bearer 인증 · multipart/form-data · JSON 응답

입력 항목
폼 항목·타입
필수
설명·예제
없음string
선택
응답과 성공 판정

HTTP 성공과 업무 결과를 구분하세요. 아래 서비스별 결과 필드가 실제 성공·실패를 나타냅니다.

정적 연동 예시입니다. 실제 계정·개인정보를 조회하지 않습니다.

추가 입력 조건·전송 규칙
Header
이름
필수
설명
Authorization
O
Bearer 인증키

응답 상세

서비스 고유 응답·필드 상세 설명
Body
이름
타입
설명
data
Object
조회 데이터
result
Array
은행 코드 목록
{}
Object
은행 코드 정보
code
String
은행 코드
content
String
은행명
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

경로별 응답 예시와 필드 명세는 위 API 요청 설명에 붙어 있습니다. JSON을 파일로 저장하기 전에는 Content-Type과 오류를 확인하세요.

상태·오류·재시도

HTTP 상태 → API 처리 여부 → 업무 상태 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

공통 폼 입력 오류

FORM_DATA_INVALID · HTTP 400: 필드 이름·타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.

FORM_DATA_FIELD_CONFLICT · HTTP 400: 같은 값과 중첩 경로를 동시에 지정하지 마세요.

MULTIPART_LIMIT_OR_PARSE_ERROR · HTTP 400/413: boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·제한·이용 조건

기능·제공 범위·요금·제한 전체 보기
Method
URL
POST
https://apick.app/rest/bank_code

저축은행(050) 포함 기관

저축은행 계좌는 기관별 코드가 따로 나뉘지 않고 050 하나로 조회됩니다. 아래 79개 저축은행이 모두 050에 포함되며, bank_code=050으로 조회할 수 있습니다.
권역
포함 저축은행
서울 (23개)
DB, JT친애, KB, NH, OK, OSB, SBI, 대신, 더케이, 민국, HB, 스카이, 바로, 신한, 애큐온, 예가람, 웰컴, 유안타, 다올, 조은, 키움예스, 푸른, 하나
인천/경기 (19개)
JT, 금화, 남양, 모아, 부림, 삼정, 상상인, 세람, 안국, 안양, 영진, 융창, 인성, 인천, 키움, 페퍼, 평택, 한국투자, 한화
부산/경남 (12개)
BNK, DH, IBK, 고려, 국제, 동원제일, 솔브레인, 에스앤티, 우리, 조흥, 진주, 흥국
대구/경북/강원 (11개)
CK, 대백, 대아, 대원, 드림, 라온, 머스트삼일, 엠에스, 오성, 유니온, 참
광주/전남/전북/제주 (7개)
대한, 라인, 동양, 삼호, 센트럴, 스마트, 스타
대전/충남/충북 (7개)
대명, 상상인플러스, 아산, 우리금융, 오투, 청주, 한성

연동 시 확인할 내용

예제는 경로별로 최소 요청과 오류 처리 포함 모드를 제공합니다. 실제 사용 환경의 시간 제한·취소·업무 성공 판정을 적용하세요.

추가 예제·서비스별 연동 안내
응답 예시

{
	"data": {
		"result": [
			{
				"code": "088",
				"content": "신한"
			},
			{
				"code": "035",
				"content": "제주"
			},
			{
				"code": "004",
				"content": "국민"
			},
			{
				"code": "003",
				"content": "기업"
			},
			{
				"code": "011",
				"content": "농협"
			},
			{
				"code": "002",
				"content": "산업"
			},
			{
				"code": "007",
				"content": "수협"
			},
			{
				"code": "048",
				"content": "신협"
			},
			{
				"code": "020",
				"content": "우리"
			},
			{
				"code": "081",
				"content": "하나"
			},
			{
				"code": "027",
				"content": "한국씨티"
			},
			{
				"code": "090",
				"content": "카카오뱅크"
			},
			{
				"code": "089",
				"content": "케이뱅크"
			},
			{
				"code": "092",
				"content": "토스뱅크"
			},
			{
				"code": "039",
				"content": "경남"
			},
			{
				"code": "034",
				"content": "광주"
			},
			{
				"code": "031",
				"content": "아이엠뱅크(대구)"
			},
			{
				"code": "032",
				"content": "부산"
			},
			{
				"code": "037",
				"content": "전북"
			},
			{
				"code": "030",
				"content": "회원수협"
			},
			{
				"code": "045",
				"content": "새마을"
			},
			{
				"code": "071",
				"content": "우체국"
			},
			{
				"code": "050",
				"content": "저축은행"
			},
			{
				"code": "012",
				"content": "지역농.축협"
			},
			{
				"code": "055",
				"content": "도이치"
			},
			{
				"code": "063",
				"content": "중국"
			},
			{
				"code": "067",
				"content": "중국건설"
			},
			{
				"code": "062",
				"content": "중국공상"
			},
			{
				"code": "061",
				"content": "BNP파리바"
			},
			{
				"code": "060",
				"content": "BOA"
			},
			{
				"code": "054",
				"content": "HSBC"
			},
			{
				"code": "057",
				"content": "JP모간"
			},
			{
				"code": "023",
				"content": "SC"
			},
			{
				"code": "064",
				"content": "산림조합"
			},
			{
				"code": "278",
				"content": "신한투자증권"
			},
			{
				"code": "261",
				"content": "교보증권"
			},
			{
				"code": "227",
				"content": "다올투자증권"
			},
			{
				"code": "267",
				"content": "대신증권"
			},
			{
				"code": "287",
				"content": "메리츠증권"
			},
			{
				"code": "238",
				"content": "미래에셋증권"
			},
			{
				"code": "290",
				"content": "부국증권"
			},
			{
				"code": "240",
				"content": "삼성증권"
			},
			{
				"code": "221",
				"content": "상상인증권"
			},
			{
				"code": "291",
				"content": "신영증권"
			},
			{
				"code": "266",
				"content": "에스케이증권"
			},
			{
				"code": "209",
				"content": "유안타증권"
			},
			{
				"code": "280",
				"content": "유진투자증권"
			},
			{
				"code": "265",
				"content": "LS증권"
			},
			{
				"code": "288",
				"content": "카카오페이증권"
			},
			{
				"code": "292",
				"content": "케이프투자증권"
			},
			{
				"code": "264",
				"content": "키움증권"
			},
			{
				"code": "271",
				"content": "토스증권"
			},
			{
				"code": "294",
				"content": "우리투자증권"
			},
			{
				"code": "270",
				"content": "하나증권"
			},
			{
				"code": "262",
				"content": "아이엠증권"
			},
			{
				"code": "243",
				"content": "한국투자증권"
			},
			{
				"code": "269",
				"content": "한화투자증권"
			},
			{
				"code": "263",
				"content": "현대차증권"
			},
			{
				"code": "224",
				"content": "BNK투자증권"
			},
			{
				"code": "279",
				"content": "DB증권"
			},
			{
				"code": "225",
				"content": "IBK투자증권"
			},
			{
				"code": "218",
				"content": "KB증권"
			},
			{
				"code": "247",
				"content": "NH투자증권"
			}
		],
		"success": 1
	},
	"api": {
		"success": true,
		"cost": 0,
		"ms": 431,
		"pl_id": -1
	}
}
            

개발가이드 검색

필요한 API와 이용 요금을 함께 확인하세요.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.