튜토리얼

ASP 개발환경에서 팝빌 SDK를 추가하고, 예금주성명 조회 (CheckAccountInfo) API를 호출하는 기본 과정을 단계별로 따라 해볼 수 있도록 구성된 가이드 입니다.

1. POPBiLL SDK 추가 및 설정

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

② 압축해제한 SDK 예제코드에 포함된 Popbill/ 폴더를 웹사이트 Root Directory 경로에 복사합니다.

③ 예금주조회 서비스 연동환경 설정을 위해 프로젝트 Root Directory에 common.asp 파일을 생성하고 아래의 코드를 참고하여 API Key 를 설정합니다.

<!--#include virtual="/Popbill/Popbill.asp"-->
<!--#include virtual="/Popbill/AccountCheckService.asp"-->

<%
  ' 링크아이디
  LinkID = "LINKID"

  ' 비밀키
  SecretKey = "SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="

  ' 예금주조회 서비스 객체 선언
  set m_AccountCheckService = new AccountCheckService

  ' 예금주조회 서비스 객체 초기화
  m_AccountCheckService.Initialize LinkID, SecretKey

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

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

  ' 통신 IP 고정, True-사용, False-미사용, (기본값:False)
  m_AccountCheckService.UseStaticIP = False

  ' 로컬시스템 시간 사용여부, True-사용, False-미사용, (기본값:True)
  m_AccountCheckService.UseLocalTimeYN = True
%>

2. CheckAccountInfo 기능 구현

프로젝트에 함수 호출을 처리하는 파일을 생성하고, 아래의 코드를 참조하여 코드를 추가합니다.

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Popbill ASP Example</title>
</head>
<!--#include file="common.asp"-->
<%
   '**************************************************************
    ' 1건의 계좌정보에 대한 예금주정보를 조회합니다.
    '**************************************************************

    '팝빌회원 사업자번호, "-" 제외
    testCorpNum = "1234567890"

    '팝빌회원 아이디
    UserID = "testkorea"

    '기관코드
    BankCode = "0011"

    '계좌번호
    AccountNumber = ""

    On Error Resume Next
        Set result = m_AccountCheckService.checkAccountInfo(testCorpNum, BankCode, AccountNumber, UserID)
        If Err.Number <> 0 then
            code = Err.Number
            message = Err.Description
            Err.Clears
        End If
    On Error GoTo 0
%>
    <body>
        <div>
            <p>Response</p>
            <fieldset>
                <legend>예금주조회</legend>
                <% If code = 0 Then %>
                <ul>
                    <li>bankCode (기관코드) : <%= result.bankCode%></li>
                    <li>accountNumber (계좌번호) : <%= result.accountNumber%></li>
                    <li>accountName (예금주 성명) : <%= result.accountName%></li>
                    <li>checkDate (확인일시) : <%= result.checkDate%></li>
                    <li>result (상태코드) : <%= result.result%></li>
                    <li>resultMessage (상태메시지) : <%= result.resultMessage%></li>
                </ul>
                <% Else %>
                <ul>
                    <li>Response.code: <%=code%> </li>
                    <li>Response.message: <%=message%> </li>
                </ul>
                <% End If %>
            </fieldset>
        </div>
    </body>
</html>

3. API 응답결과 확인

API 호출 응답결과는 다음과 같습니다.

구분	응답
성공	result(상태코드) : 100
실패	code : 오류코드 (8자리 음의 정수) [오류코드] message : 오류메시지