튜토리얼

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

1. POPBiLL SDK 추가

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

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

2. POPBiLL SDK 설정

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

Declare Instance Variables 탭

// 링크아이디, 연동신청시 발급받은 값으로 변경
string in_linkid = "TESTER"

// 비밀키, 연동신청시 발급받은 값으로 변경
string in_secretkey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

easyfinbankservice in_easyfinbankservice

Window Form Open() 함수

in_easyfinbankservice = create easyfinbankservice

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

// 비밀키
in_easyfinbankservice.secretkey = in_secretkey

// 연동환경 설정값, true-개발용, false-상업용
in_easyfinbankservice.setIstest(true)

// 인증토큰 IP제한기능 사용여부, true-사용, false-미사용, 기본값(true)
in_easyfinbankservice.setIPRestrictOnOff(true)

// 로컬시스템 시간 사용여부 true-사용, false-미사용, 기본값(false)
in_easyfinbankservice.setUseLocalTimeYN(false)

3. RequestJob 기능 구현

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

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

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

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

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

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

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. 결과 확인

함수 호출이 정상적으로 처리된 경우 Response가 "성공"으로 반환되며, 실패일 경우 PopbillException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드] 바로가기