튜토리얼

.NET 개발환경에서 팝빌 SDK를 추가하여 예금주성명 조회 (CheckAccountInfo) 함수를 구현하는 예시입니다.

1. POPBiLL SDK 추가

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

② 다운받은 SDK 예제코드의 Linkhub/, Popbill/ 폴더를 SDK를 적용할 프로젝트 경로에 복사하고. Linkhub.csproj, Popbill.csproj를 각각 기존 프로젝트로 추가합니다.

③ Popbill 프로젝트를 적용할 프로젝트의 참조로 추가합니다.

2. POPBiLL SDK 설정

연동환경 설정값, 예금주조회 서비스 클래스를 선언하고 Form1_Load() 함수에 서비스 클래스 초기화 코드를 추가합니다.

Public Class Form1
  '링크아이디
  Private Const LinkID As String = "TESTER"

  '비밀키
  Private SecretKey As String = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

  '예금주조회 서비스 객체 선언
  Private accountCheckService As AccountCheckService

  Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    '예금주조회 서비스 객체 초기화
    accountCheckService = New AccountCheckService(LinkID, SecretKey)

    '연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
    accountCheckService.IsTest = True

    '인증토큰 IP 검증 설정, true-사용, false-미사용, (기본값:true)
    accountCheckService.IPRestrictOnOff = True

    '통신 IP 고정, true-사용, false-미사용, (기본값:false)
    accountCheckService.UseStaticIP = false;

    '로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:false)
    accountCheckService.UseLocalTimeYN = False

  End Sub
End Class

3. CheckAccountInfo 기능 구현

Windows Form에 버튼을 생성하고 버튼의 Click Event 코드에 예금주조회 성명조회 (CheckAccountInfo) 함수 호출 코드를 추가합니다.

Public Class Form1

    Private Sub btnCheckAccountInfo_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnCheckAccountInfo.Click

        Try
            Dim accountInfo As AccountCheckInfo = accountCheckService.CheckAccountInfo(txtCorpNum.Text, txtBankCode.Text, txtAccountNumber.Text)

            Dim tmp As String = ""

            tmp += "bankCode (기관코드) : " + accountInfo.bankCode + vbCrLf
            tmp += "accountNumber (계좌번호) : " + accountInfo.accountNumber + vbCrLf
            tmp += "accountName (예금주 성명) : " + accountInfo.accountName + vbCrLf
            tmp += "checkDate (확인일시) : " + accountInfo.checkDate + vbCrLf
            tmp += "result (응답코드) : " + accountInfo.result + vbCrLf
            tmp += "resultMessage (응답메시지) : " + accountInfo.resultMessage + vbCrLf

            MsgBox(tmp)

        Catch ex As PopbillException
            MsgBox("code(응답코드) : " + ex.code.ToString + vbCrLf + "message(응답메시지) : " + ex.Message)
        End Try
    End Sub
End Class

4. 결과 확인

함수 호출 반환 결과는 아래와 같습니다.
- 성공 : result(상태코드) 숫자 100 반환
- 실패 : PopbillException 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]