튜토리얼

PowerBuilder 개발환경에서 팝빌 SDK를 추가하여 계좌 거래내역 수집요청 (RequestJob) 함수를 구현하는 예시입니다.

1. POPBiLL SDK 추가

① 팝빌 연동자료실에서 PowerBuilder SDK 예제코드 다운로드 후 압축을 해제합니다.

② 압축해제한 SDK 예제코드에서 linkhub.pbl, popbill.pbl 파일을 기존 프로젝트 폴더로 복사하고 Library List에 추가합니다.

2. POPBiLL SDK 설정

Window 폼의 Declare Instance Variables 탭에 API Key 와 클래스를 선언하고 open() 함수에 클래스 초기화 코드를 추가합니다.

Declare Instance Variables 탭

  // 링크아이디
  in_easyfinbankservice.linkid = in_linkid

  // 비밀키
  in_easyfinbankservice.secretkey = in_secretkey

  // 계좌조회 서비스 객체 선언
  easyfinbankservice in_easyfinbankservice

Window Form Open() 함수

3. RequestJob 기능 구현

Form에 버튼을 생성하고 버튼의 Click Event 코드에 계좌 거래내역 수집요청 (RequestJob) 기능을 추가합니다.

/********************************************************
* 거래내역 수집을 요청합니다.
* - 검색기간은 현재일 기준 90일 이내로만 요청할 수 있습니다.
* - 수집 요청후 반환받은 작업아이디(JobID)의 유효시간은 1시간 입니다.
********************************************************/
// 팝빌 회원 사업자번호
string corpNum = "1234567890"

// 기관코드
string bankCode = "0048"

// 계좌번호
string accountNumber = "3011599770921"

// 시작일자, yyyyMMdd
string sdate = "20250201"

// 종료일자, yyyyMMdd
string edate = "20250228"

string jobid

try

	 jobid = in_easyFinBankService.requestjob(corpNum, bankCode, accountNumber, sdate, edate)

 	 messagebox("수집 요청", "작업아이디(jobID) : " +jobid)

	 sle_jobid.text = jobid

catch(popbillexception pe)

	messagebox("수집 요청", "응답코드 : " + String(pe.getcode()) + "~n응답메시지 : " + pe.getmessage())

end try

4. 결과 확인

함수 호출 반환 결과는 아래와 같습니다.
- 성공 : JobID(작업아이디) 18자리 문자열 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]