POPBill Developers
API Reference

2. 계좌 거래내역 수집

2.1. RequestJob - 수집 요청

  • 계좌 거래내역을 확인하기 위해 팝빌에 수집요청을 합니다. (조회기간 단위 : 최대 1개월)

    ※ 조회일로부터 최대 3개월 이전 내역까지 조회할 수 있습니다.

easyFinBankService.requestJob(CorpNum, BankCode, AccountNumber, SDate, EDate, UserID, success, error)
  • 반환 받은 작업아이디는 함수 호출 시점부터 1시간 동안 유효합니다.
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
BankCode string 4 Y 은행 기관코드
  • 0011농협
  • 0004국민은행
  • 0020우리은행
  • 0088신한은행
  • 0003기업은행
  • 0081하나은행
  • 0023SC은행
  • 0002산업은행
  • 0027씨티은행
  • 0031대구은행
  • 0032부산은행
  • 0039경남은행
  • 0034광주은행
  • 0037전북은행
  • 0035제주은행
  • 0071우체국
  • 0045새마을금고
  • 0048신협
  • 0007수협
AccountNumber string 30 Y 계좌번호
SDate string 8 Y 조회 기간의 시작일자
형식 : yyyyMMdd
EDate string 8 Y 조회 기간의 종료일자
형식 : yyyyMMdd
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

string - 요청에 대한 작업아이디(JobID)

Throws

PopbillException

2.2. GetJobState - 수집 상태 확인

easyFinBankService.getJobState(CorpNum, JobID, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
JobID string 18 Y 작업아이디
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

EasyFinBankJobState

Throws

PopbillException

2.3. ListActiveJob - 수집 상태 목록 확인

  • [RequestJob - 수집 요청]를 통해 반환 받은 작업아이디의 목록을 확인합니다.
  • 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
easyFinBankService.listActiveJob(CorpNum, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

EasyFinBankJobState[ ]

Throws

PopbillException