# 실명조회

## 1. CheckDepositorInfo - 실명조회

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

```javascript
accountCheckService.checkDepositorInfo(CorpNum, BankCode, AccountNumber, IdentityNumType, IdentityNum, UserID, success, error)
```

### 요청

**Parameters**

- CorpNum `type: string` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- BankCode `type: string` `length: 4` `required: Y` `description: 조회할 기관코드`
  - [\[참고\] 조회 가능한 금융기관](https://developers.popbill.com/guide/accountcheck/introduction/depositor#account_bank_list)
- AccountNumber `type: string` `length: 14` `required: Y` `description: 조회할 기관의 계좌번호 ('-' 제외)`
  - 7자리 이상 14자리 이하
- IdentityNumType `type: string` `length: 1` `required: Y` `description: 실명번호 유형`
  - `B`: 사업자
  - `P`: 개인
- IdentityNum `type: string` `length: 10` `required: Y` `description: 실명번호 ('-' 제외)`
  - {identityNumType}="B" 경우 사업자번호
  - {identityNumType}="P" 경우 생년월일 (형식 : yyMMdd)
- UserID `type: string` `length: 50` `required: N` `description: 팝빌회원 아이디`
- success `type: function` `length: -` `required: Y` `description: 성공에 대한 콜백 함수`
- error `type: function` `length: -` `required: Y` `description: 실패에 대한 콜백 함수`

### 응답

**DepositorCheckInfo**

- result `type: string` `length: 10` `description: 상태코드`
  - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/accountcheck/node/response-code#result-code)
- resultMessage `type: string` `length: 2000` `description: 상태메시지`
- accountName `type: string` `length: 30` `description: 예금주 성명`
  - 금융기관에 따라 응답하는 최대 길이의 차이가 있음
- bankCode `type: string` `length: 4` `description: 기관코드`
  - [\[참고\] 조회 가능한 금융기관](https://developers.popbill.com/guide/accountcheck/introduction/depositor#account_bank_list)
- accountNumber `type: string` `length: 30` `description: 계좌번호`
  - 7자리 이상 14자리 이하
- identityNumType `type: string` `length: 1` `description: 실명번호 유형`
  - `B`: 사업자
  - `P`: 개인
- identityNum `type: string` `length: 10` `description: 실명번호 ('-' 제외)`
  - {identityNumType}="B" 경우 사업자번호
  - {identityNumType}="P" 경우 생년월일 (형식 : yyMMdd)
- checkDT `type: string` `length: 14` `description: 확인일시`
  - 형식 : yyyyMMddHHmmss

### 예외

**PopbillException**

- code `type: number` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- message `type: string` `length: -` `description: API 처리 실패에 대한 오류메시지`