# 실명조회

## 1. CheckDepositorInfo - 실명조회

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

```vb
Function CheckDepositorInfo(CorpNum As String, bankCode As String, accountNumber As String, identityNumType As String, identityNum As String, Optional UserID As String = "") As PBDepositorCheckInfo
```

### 요청

**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: 30` `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: 팝빌회원 아이디`

### 응답

**PBDepositorCheckInfo**

- result `type: String` `length: 10` `description: 상태코드`
  - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/accountcheck/vba/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)
- checkDate `type: String` `length: 13` `description: 확인일시`
  - 타임스탬프 (단위 : ms)

### 예외

**Err**

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