# 조회

팝빌 계좌조회에 대하여 안내합니다.

## 조회 안내

계좌의 입출금 거래내역 및 잔액을 조회합니다. 다음의 절차가 선행되어야만 계좌조회가 가능합니다.

1. **은행계좌 빠른조회 신청**\
   팝빌 계좌조회 서비스를 사용하기 위해서는 반드시 은행계좌의 빠른조회 신청이 필요합니다. [\[빠른조회 신청방법\]](https://developers.popbill.com/guide/easyfinbank/introduction/regist-bank-account#how-to-bank-apply)

2. **정액제 신청**\
   계좌조회 서비스는 등록되는 계좌 당 최초 1회 정액제 신청(결제)이 필요합니다.\
   이후 지정한 결제일에 매월 보유한 포인트를 차감하여 자동연장 됩니다.

3. **계좌 등록**\
   신청된 정액제에 계좌를 등록하여 사용합니다. [\[계좌 등록방법\]](https://developers.popbill.com/guide/easyfinbank/introduction/regist-bank-account#regist-guide)

## 조회 프로세스

계좌조회 API는 ‘수집 요청 → 수집 상태 확인 → 수집 내역 확인’ 단계로 구현합니다.

```mermaid
sequenceDiagram
      participant 파트너
      participant POPBiLL

      파트너->>POPBiLL: RequestJob - 수집 요청
      POPBiLL->>파트너: jobID(작업아이디) 반환
      loop jobState != 3(완료)
      파트너->>POPBiLL: GetJobState - 수집 상태 확인
      POPBiLL->>파트너: jobState(수집상태) 반환
      end
      POPBiLL->>POPBiLL: 수집 완료
      Note right of 파트너: jobState == 3(완료) and ErrorCode == 1(성공)
      파트너->>POPBiLL: Search - 수집 내역 확인
      POPBiLL->>파트너: 수집내역 목록 및 요약정보 반환
```

1. **수집 요청** [\[RequestJob - 수집 요청\]](https://developers.popbill.com/api-reference/easyfinbank/api/job#RequestJob)

   - 팝빌에 계좌 거래내역 수집을 요청합니다. (\*계좌 등록 후 거래내역 수집이 가능합니다.)
   - 응답받은 JobID(작업아이디)로 수집 상태를 조회할 수 있습니다. (\*JobID는 함수 호출 시점부터 1시간 동안만 유효합니다.)

2. **상태 확인** [\[GetJobState - 수집 상태 확인\]](https://developers.popbill.com/api-reference/easyfinbank/api/job#GetJobState)

   - JobID(작업아이디)로 수집 상태(접수/대기/진행/완료)와 성공 여부(성공/실패)를 확인합니다.
   - 수집 상태가 ‘완료’이고, 성공 여부가 ‘성공’인 경우에만 수집된 거래내역을 조회할 수 있습니다.

3. **거래내역 확인** [\[Search - 수집 내역 확인\]](https://developers.popbill.com/api-reference/easyfinbank/api/search#Search), [\[Summary - 수집 내역 합계\]](https://developers.popbill.com/api-reference/easyfinbank/api/search#Summary)

   - 팝빌로 수집이 완료된 계좌 거래내역 수집 내역 확인(Search) 또는 수집 내역 합계(Summary)를 확인합니다.
   - 수집이 완료된 후 거래내역(Search) 또는 거래내역 합계(Summary)를 확인합니다.

> 팝빌에서는 조회 기간의 SDate(시작일자)와 EDate(종료일자)를 이틀 단위로 설정하여 수집을 권장합니다.