조회

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

조회 안내

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

1. 은행계좌 빠른조회 신청
   팝빌 계좌조회 서비스를 사용하기 위해서는 반드시 은행계좌의 빠른조회 신청이 필요합니다. [빠른조회 신청방법]

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

3. 계좌 등록
   신청된 정액제에 계좌를 등록하여 사용합니다. [계좌 등록방법]

조회 프로세스

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

1. 수집 요청 [RequestJob - 수집 요청]

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

2. 상태 확인 [GetJobState - 수집 상태 확인]

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

3. 거래내역 확인 [Search - 수집 내역 확인], [Summary - 수집 내역 합계]

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

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