서민금융진흥원 API 규격
-
숨은 금융자산(출연) 목록 조회 v1 2025-07-16
기본 정보API ID 서금원-001 HTTP Method GET API 제공자 서민금융진흥원 API 요청자 마이데이터사업자 API 명 (URI) /v1/kinfa/sleep_cont 설명 서민금융진흥원에 출연된 휴면예금, 휴면보험금 조회
- 소멸시효가 완성되어 서민금융진흥원에 출연된 계좌 정보로 숨은 금융자산(미출연) API, 내보험찾아줌, 어카운트인포에서 제공하는 휴면예금 및 휴면보험금, 미청구보험금과 상이함
- 출연된 휴면예금 및 휴면보험금은 조회 시점 최신 정보이며, 실시간으로 지급신청 가능한 내역만 보여줌
- 목록 조회 후 지급신청 API로 연결하지 않을 경우 지급 신청 가능한 배너 안내
- 서금원-001은 서민금융진흥원만 정보제공기준시점 현재 시점 Content-Type(요청) - Content-Type (응답) application/json; charset=UTF-8 요청 메세지 명세HTTP 항목명 항목설명 필수 타입(길이) 설명(비고) Header Authorization 접근토큰 Y aNS(1500) 발급한 접근토큰
- 접근토큰 유형(Bearer)을 명시
예) Authorization: Bearer 접근토큰x-api-tran-id 거래고유번호 Y AN(25) 거래고유번호 x-api-type API 유형 Y aNS(12) 정기적/비정기적 전송 API 유형 Parameter org_code 기관코드 Y aN(10) 정보제공자 기관코드
- 지원 API로부터 배포search_timestamp 조회 타임스탬프 N N(14) 가장 최근 조회한 시간 (이전 API 호출 시 정보제공자가 회신한 값을 저장하고 있다가 다음 API 호출 시 그 값을 그대로 세팅하여 전송, 최초 API 호출시에는 0으로 세팅)
- 2.1-[2] 참조
- next_page가 세팅된 경우 요청에서 제외next_page 다음 페이지 기준개체 N aNS(1000) 다음 페이지 요청을 위한 기준개체 (설정 시 해당 개체 후 limit 개 반환)
처음 API 호출 시에는 해당 정보를 세팅하지 않으며, 다음 페이지 요청 시 직전 조회의 응답에서 얻은 기준개체를 그대로 세팅
- 2.1-[2] 페이지네이션 참조limit 최대조회갯수 Y N(3) 기준개체 이후 반환될 개체의 개수
- 최대 500까지 설정 가능응답메세지 명세HTTP 항목명 항목설명 필수 타입(길이) 설명(비고) Header x-api-tran-id 거래고유번호 Y AN(25) 거래고유번호 Body rsp_code 세부 응답코드 Y aN(5) rsp_msg 세부 응답메시지 Y AH(450) search_timestamp 조회 타임스탬프 N N(14) API 처리 시점의 현재시각을 설정하여 회신. 다만 정보제공자는 Timestamp 로직을 의무적으로 구현할 필요가 없으며(선택사항), Timestamp 로직 미제공 시에는 항상 0을 회신 또는 미회신
- 2.1-[2] 참조next_page 다음 페이지 기준개체 N aNS(1000) 다음 페이지 요청을 위한 기준개체
- 다음 페이지 존재하지 않는 경우(마지막 페이지), 미회신
- 2.1-[2] 페이지네이션 참조sleep_cnt 보유계좌수 Y N(3) sleep_list 보유계좌목록 Y Object --is_consent 전송요구 여부 Y Boolean 정보주체가 해당 자산(계약관리번호)에 대해 개인신용정보 전송요구를 했는지 여부 --sleep_type 숨은 금융자산 구분(코드) Y aN(2) 해당 자산의 상품 구분 코드
<코드값>
- 10 : 은행예금
- 20 : 생명보험 상품
- 30 : 손해보험 상품
- 40 : 우체국예금
- 50 : 우체국보험
- 70 : 상호저축은행 예금
- 99 : 기타--account_status 숨은 금융자산 구분(코드) Y aN(2) 예금의 지급 관련 상태 코드가 출연, 압류 및 지금 처리중인 계좌 경우만 조회 가능
<코드값>
- 01 : 출연(정상)
- 03 : 지급 처리중
- 07 : 압류계좌--adm_orig_name 원권리자명 Y AH(30) 서금원에 출연된 숨은금융자산의 원권리자 이름
- 원권리자명이 목록 조회한 고객의 이름과 다를 경우 지급신청이 불가능하도록 처리--sleep_num 계좌번호 또는 보험증권번호 Y aN(20) 서금원에 출연된 숨은금융자산의 계좌번호 또는 보험증권번호 --cont_org_code 서금원에 출연된 숨은금융자산의 출연 전 금융회사 코드(서금원으로 자산을 출연한 금융회사의 코드)
*지원 API로부터 배포되는 기관코드 중 앞 2자리를 제외한 8자리 회신(자세한 내용은 서비스 가이드라인 참조)
- 기관코드는 업권코드(2자리), 대표기관코드(4자리), 지점코드(4자리)로 구성되는데, 여러 업권의 정보를 보유한 금융기관은 다수의 기관코드를 보유(업권별 기관코드 할당)할 수 있기 때문에 업권코드를 제외한 8자리 코드를 사용하여 유일성 확보
*종합포털로부터 기관코드를 발급받지 않는 기관
- 한국예탁결제원 : 0000KSED
- 도이치뱅크 : 0000DEBK
- 야마구치은행 : 0000YGBK
-인도해외은행 : 0000IIBKY aN(10) 서금원에 출연된 숨은금융자산의 계좌번호 또는 보험증권번호 --ext_pres_date 소멸시효완성일 N N(14) 소멸시효 완성일
- 관련 법률의 규정 또는 당사자의 약정에 따라 채권 또는 청구권의 소멸시효가 완성된 날짜--cont_date 출연일 Y N(14) 숨은금융자산이 금융회사에서 서금원으로 출연(이관)된 날짜 --cont_amount 출연금액 Y F(18,3) 서금원으로 출연된 숨은금융자산으로, 금융회사에서 출연한 실지급 금액
• 일부 이자ㆍ세금이 반영되지 않은 출연된 금액으로 실지급금액과 상이할 수 있음
• 액수 상관없이 서금원에 출연된 모든 계좌ㆍ증권의금액을 표시
• 2000만원 초과 건의 경우 지급신청 불가능하도록 처리 -
전송요구 내역 조회 (공통) v1 2025-07-16
기본 정보API ID 정보제공-공통-002 (서금원) HTTP Method GET API 제공자 공통 API 요청자 마이데이터사업자 API 명 (URI) /v1/kinfa/consents 설명 정보주체가 특정한 전송요구 내역 조회
- • 정보주체 선택에 따라 전송 주기(fnd_cycle, add_cycle)를 설정기준시점 현재 시점 Content-Type(요청) - Content-Type (응답) application/json; charset=UTF-8 요청 메세지 명세HTTP 항목명 항목설명 필수 타입(길이) 설명(비고) Header Authorization 접근토큰 Y aNS(1500) 발급된 접근토큰
- 접근토큰 유형(Bearer)을 명시
예) Authorization: Bearer 접근토큰x-api-tran-id 거래고유번호 Y AN(25) 거래고유번호 x-api-type API 유형 Y aNS(12) 정기적/비정기적 전송 API 유형 Parameter org_code 기관코드 Y aN(10) - 지원 API로부터 배포 응답메세지 명세HTTP 항목명 항목설명 필수 타입(길이) 설명(비고) Header x-api-tran-id 거래고유번호 Y AN(25) 거래고유번호 Body rsp_code 세부 응답코드 Y aN(5) rsp_msg 세부 응답메시지 Y AH(450) is_scheduled 정기적 전송 여부 Y Boolean 정기적 전송을 요구하는지 여부 fnd_cycle 전송 주기(기본정보) N aNS(5) 기본정보의 정기적 전송 주기
· 규격 : 횟수/기준 (기준:월=“m”, 주=“w”, 일=“d”)
<예시>
1/nw : n주 1회(n = '1','2','3','4')
1/d : 일1회
· is_scheduled='true'인 경우 회신
※1주 단위 간격으로만 설정이 가능)
(예 : 1주차 금요일, 2주차 월요일 불가)add_cycle 전송 주기(추가정보) N aNS(5) 추가정보의 정기적 전송 주기
- 규격 : fnd_cycle과 동일
- is_scheduled='true'인 경우 회신
※1주 단위 간격으로만 설정이 가능)
(예 : 1주차 금요일, 2주차 월요일 불가)end_date 종료시점 Y DATE 전송요구 종료 시점
- 자산목록 전송요구(1차 통합인증) 시 : 전송요구시점부터 7일째 되는 일자 (예: 2021.12.1. 전송요구 시 종료시점은 +7일인 2021.12.8.)
- 개별인증 시 또는 자산에 대한 세부 전송요구(2차 통합인증) 시 : 전송요구시점부터 1년째 되는 일자 (예: 2021.12.1. 전송요구 시 종료시점은 +1년인 2022.12.1.) 또는 고객이 선택한 일자purpose 목적 Y AH(150) 전송을 요구하는 목적 period 보유기간 Y DATE 전송을 요구하는 개인신용정보의 보유기간
- 자산목록 전송요구(1차 통합인증) 시 : 전송요구시점부터 7일째 되는 일자 (예: 2021.12.1. 전송요구 시 보유기간은 +7일인 2021.12.8.)
- 개별인증 시 또는 자산에 대한 세부 전송요구(2차 통합인증) 시 : '99991231' 고정값
- '99991231' : '서비스 이용 종료시 또는 삭제요구시 까지'를 의미is_consent_trans_memo 적요/거래메모 전송요구 여부 N Boolean 정보주체가 보유한 수신계좌의 거래내역 중 적요/거래메모(trans_memo) 정보에 대해 개인신용정보 전송요구를 했는지 여부
- 적용업권 : 은행업권, 전자금융업권 (그 외 업권은 미회신)
- “true”인 경우 :
- 은행업권 : 은행-004에서 적요 회신
- 전자금융업권 : 전금-004, 전금-103에서 거래메모 회신
- “false”인 경우 :
- 은행업권 : 은행-004에서 적요 미회신
- 전자금융업권 : 전금-004, 전금-103에서 거래메모 미회신is_consent_merchant_name_regno 가맹점명/사업자등록번호 전송요구 여부 N Boolean 가맹점명(merchant_name) 및 사업자등록번호(merchant_regno) 정보에 대해 개인신용정보 전송요구를 했는지 여부
- 적용업권 : 카드업권, 전자금융업권, 통신업권 (그 외 업권은 미회신)
- “true”인 경우 :
- 카드업권 : 카드-005, 카드-008, 선불-004에서 가맹점명 및 사업자등록번호 회신, 카드-009에서 가맹점명 회신
- 전자금융업권 : 전금-004에서 가맹점명 회신, 전금-103에서 가맹점명 및 사업자등록번호 회신
- 통신업권 : 통신-004에서 가맹점명 회신
- “false”인 경우 :
- 카드업권 : 카드-005, 카드-008, 선불-004에서 가맹점명 및 사업자등록번호 미회신, 카드-009에서 가맹점명 미회신
- 전자금융업권 : 전금-004에서 가맹점명 미회신, 전금-103에서 가맹점명 및 사업자등록번호 미회신
- 통신업권 : 통신-004에서 가맹점명 미회신is_consent_trans_category 상품(구매)분류 전송요구 여부 N Boolean 정보주체의 결제내역 중 상품(구매)분류(코드)(trans_category) 정보에 대해 개인신용정보 전송요구를 했는지 여부
- 적용업권 : 전자금융업권 (그 외 업권은 미회신)
- “true”인 경우 :
- 전자금융업권 : 전금-004, 전금-103에서 상품(구매)분류 (코드) 회신
- “false”인 경우 :
- 전자금융업권 : 전금-004, 전금-103에서 상품(구매)분류 (코드) 미회신
서민금융진흥원 API 규격