SDK 환경설정
팝빌 SDK에는 프로그램 공급사의 개발환경을 지원하기 위한 별도의 Config 값이 존재하며, 개발환경에 따라 변수 값을 변경하여 팝빌 API를 이용할 수 있습니다.
<!--#include virtual="/Popbill/Popbill.asp"-->
<!--#include virtual="/Popbill/StatementService.asp"-->
<%
' 링크허브에서 발급받은 인증정보 링크아이디(LinkID), 비밀키(SecretKey) 입력
LinkID = "LINKID"
SecretKey = "SwWxqU+0TExEXy/9TVjKPExI2VTUMMSLZtJf3Ed8q3I="
' 세금계산서 서비스 모듈 생성
set m_StatementService = new StatementService
' 세금계산서 API 서비스 모듈 초기화
m_StatementService.Initialize LinkID, SecretKey
' 연동환경 설정값, True - 개발용(테스트베드), False - 상업용(실서비스)
m_StatementService.IsTest = True
' 인증토큰 IP제한기능 사용여부, 권장(True)
m_StatementService.IPRestrictOnOff = True
' 팝빌 API 서비스 고정 IP 사용여부, Ture-사용, False-미사용, 기본값(False)
m_StatementService.UseStaticIP = False
' 로컬시스템 시간 사용여부 True-사용(기본값-권장), false-미사용
m_StatementService.UseLocalTimeYN = True
%>
1. 테스트(Sandbox) ↔ 운영(Production) 환경설정 – IsTest
팝빌은 독립적으로 운영되는 테스트(Sandbox)와 운영(Production) 환경을 지원하며 IsTest 변수로 연동환경을 전환할 수 있습니다. 팝빌 API 이용을 위한 고유 인증코드는 양쪽 환경에서 동일하게 사용되며, 상업용 전환 후에도 환경설정 변수 값 변경으로 테스트 환경과 운영 환경을 모두 이용하실 수 있습니다.
구분 | true (=기본값) | false |
IsTest | 테스트 (Sandbox) | 운영 (Production) |
URL | https://test.popbill.com | https://www.popbill.com |
인증정보 | 동일한 인증코드(LinkID/SecretKey) 사용 | |
국세청신고 | X (가상으로 처리) | Y |
최초 운영(Production) 서비스로의 전환은 전환 신청절차를 통해 처리 가능합니다. [운영(Production) 전환] 신청하기
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
시스템 내부 보안 또는 방화벽 정책에 의해 고정 IP로 팝빌 API를 이용하는 프로그램 공급사의 경우 UseStaticIP 변수 값으로 고정 IP 사용 여부를 설정할 수 있습니다. 팝빌은 사전에 지정한 IP의 통신 접근만을 허용하는 IP 화이트리스트를 제공함으로써 프로그램 공급사의 안전한 데이터 통신을 지원합니다.
구분 | true | false (=기본값) |
UseStaticIP | 고정 IP 사용 | 유동 IP 사용 |
-
기본 도메인(Elastic IP) : 방화벽 정책 또는 보안장치 등록 불가
- 1) 인증서버 : https://auth.linkhub.co.kr
- 2) 운영(Production) : https://popbill.linkhub.co.kr
- 3) 테스트(Sandbox) : https://popbill-test.linkhub.co.kr
-
고정 도메인(Static IP) : 52.78.164.186 / 13.124.222.90
- 1) 인증서버 : https://static-auth.linkhub.co.kr
- 2) 운영(Production) : https://static-popbill.linkhub.co.kr
- 3) 테스트(Sandbox) : https://static-popbill-test.linkhub.co.kr