POPBill Developers
가이드

SDK 환경설정

팝빌 SDK에는 프로그램 공급사의 개발환경을 지원하기 위한 별도의 Config 값이 존재하며, 개발환경에 따라 변수 값을 변경하여 팝빌 API를 이용할 수 있습니다.

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

<%
  ' 링크아이디
  LinkID = "LINKID"
  
  ' 비밀키
  SecretKey = "SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="

  ' 카카오톡 서비스 객체 선언
  set m_KakaoService = new KakaoService

  ' 카카오톡 서비스 객체 초기화
  m_KakaoService.Initialize LinkID, SecretKey

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

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

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

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

1. 테스트 ↔ 운영(PROD) 전환 설정 – IsTest

팝빌은 테스트와 운영 환경을 독립적으로 지원하며 IsTest 변수를 이용하여 자유롭게 환경 전환(테스트↔운영)이 가능합니다.

구분 테스트 운영(Production)
IsTest true (기본값) false
URL https://test.popbill.com https://www.popbill.com
국세청신고 가상으로 처리 실제 국세청 신고
API Key

동일한 API Key (LinkID/SecretKey) 사용

※ 테스트와 운영 환경을 구별하여 API Key 사용이 필요한 경우 별도 협의가 필요합니다.

운영 전환을 위한 SDK 환경설정 변경 방법
  • ASP SDK
    1. "common.asp" 파일의 IsTest Property 값을 True 에서 False 로 변경합니다.

팝빌 운영 전환은 제반사항(계약, 결제 등)에 대해 사전 협의가 필요합니다. [운영(PROD) 전환신청]

2. 인증 토큰 IP 설정 – IsIPRestrictOnOff

팝빌 API를 이용하기 위해서는 팝빌 인증서버로부터 Bearer Token 발급이 필요하며, 발급된 Token으로만 API 함수 호출이 가능합니다. 제 3자의 스누핑/스니핑에 의한 오사용 및 제반 사고를 방지하기 위해 팝빌 시스템은 Bearer Token 발급을 요청한 IP와 API를 호출하는 IP의 일치 여부를 검증하고 있으며, IsIPRestrictOnOff 변수에 따라 사용 여부를 설정할 수 있습니다.

구분 true (기본값) false
IsIPRestrictOnOff 인증 요청 IP↔API 호출 IP 일치 검증 인증 요청 IP↔API 호출 IP 일치 검증 생략
링크허브 인증토큰 발급 과정

3. 통신 IP 고정(방화벽 지원) – UseStaticIP

고객사 보안정책(방화벽 설정 등)으로 인해 Outbound Traffic(고객사→팝빌)의 고정 IP 설정이 필요한 경우, 팝빌 SDK 설정의 UseStaticIP 변수 값의 변경이 필요합니다. IP 주소 및 URL 확인

구분 true false (기본값)
UseStaticIP 고정 IP 사용 유동 IP 사용