실명조회

1. CheckDepositorInfo - 실명조회

POST https://popbill-test.linkhub.co.kr/EasyFin/DepositorCheck

POST https://popbill.linkhub.co.kr/EasyFin/DepositorCheck

1건의 예금주실명을 조회합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

변수명	타입	길이	필수	설명
c	string	4	Y	조회할 기관코드 [참고] 조회 가능한 금융기관
n	string	30	Y	조회할 기관의 계좌번호 ('-' 제외) 7자리 이상 14자리 이하
t	string	1	Y	실명번호 유형 B사업자 P개인
p	string	10	Y	실명번호 ('-' 제외) - {identityNumType}="B" 경우 사업자번호 - {identityNumType}="P" 경우 생년월일 (형식 : yyMMdd)

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/DepositorCheck?c={c}&n={n}&t={t}&p={p}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
result	string	10	상태코드 [참고] 팝빌 상태코드
resultMessage	string	2000	상태메시지
accountName	string	30	예금주 성명 금융기관에 따라 응답하는 최대 길이의 차이가 있음
bankCode	string	4	기관코드 [참고] 조회 가능한 금융기관
accountNumber	string	30	계좌번호 7자리 이상 14자리 이하
identityNumType	string	1	실명번호 유형 B사업자 P개인
identityNum	string	10	실명번호 ('-' 제외) - {identityNumType}="B" 경우 사업자번호 - {identityNumType}="P" 경우 생년월일 (형식 : yyMMdd)
checkDT	string	14	확인일시 형식 : yyyyMMddHHmmss

응답 예시

{
    "bankCode": "0012",
    "accountNumber": "계좌번호",
    "accountName": "예금주 성명",
    "checkDate": 1760948118461,
    "result": 100,
    "resultMessage": "성공",
    "identityNum": "971224",
    "identityNumType": "P",
    "checkDT": "20251020171518"
}