팝빌 연동환경
팝빌은 팝빌 테스트 환경과 팝빌 운영(Production) 환경을 독립적으로 운영하고, 팝빌 운영(Production) 환경과 모든 기능이 동일하게 작동하는 팝빌 테스트 환경을 제공하여 실제 서비스와 동일한 조건에서 연동개발이 가능하도록 지원하고 있습니다.
- 독립적인 개발환경
- 동일 API Key (LinkID, SecretKey) 사용
- 테스트포인트 무료 지원 (일부 제한)
팝빌 테스트 환경에서는 세금계산서 국세청 전송을 가상으로 처리하고 있기 때문에 실제로 국세청에 신고되지 않습니다.
연동절차
-
연동신청 : 프로그램 공급사 사업자정보로 연동신청 합니다. [연동신청]
개발 테스트를 위하여 연동신청에 필요한 입력정보는 아래와 같습니다.
- 1) 회사정보 – 사업자번호, 회사명, 대표자, 업태, 종목, 주소
-
2) 계정정보 – ID, PW
- 입력하신 정보로 팝빌 파트너 관리자와 팝빌 테스트 사이트와 팝빌 운영(Prodution) 사이트 계정이 생성됩니다.
- 승인이 완료된 ID는 변경이 불가하므로 개인이 아닌 회사를 대표하는 계정정보로 신청하여 주시기 바랍니다.
- 3) 담당자정보 – 이름, 이메일, 연락처
-
API Key 설정 : 팝빌에서 발급한 API Key를 수신하여 SDK에 설정합니다. [SDK 환경설정]
팝빌은 연동신청 접수 후 20분(영업일 기준) 이내에 프로그램 공급사 고유 API Key 를 발급합니다. 팝빌 전자세금계산서 API 사용을 위해 수신한 API Key 를 SDK에 설정합니다.
- 링크아이디(LinkID) : 프로그램 공급사를 식별할 수 있는 고유정보로 회원가입 등 고객사 관리에 사용됩니다.
- 비밀키(SecretKey) : API 통신전문 변조를 방지하기 위해 사용됩니다.
API Key는 프로그램 공급사를 식별할 수 있는 고유정보로 외부에 유출되지 않도록 주의합니다.
-
공동인증서 등록 : 용도에 맞는 공동인증서를 테스트 계정에 등록합니다. [공동인증서 등록]
세금계산서 발행은 등록된 공동인증서로 전자서명 하여 처리합니다. 발행 테스트를 위해서는 팝빌 테스트 계정에 용도에 맞는 프로그램 공급사의 공동인증서 등록이 필요합니다.
인증서 등록은 아래 2가지 방법을 지원합니다.
-
팝빌 사이트 등록
팝빌 테스트 사이트 로그인 (https://test.popbill.com) > 전자세금계산서 > 환경설정 > 인증서 관리 > 인증서 등록
-
API 등록
인증서 등록 API를 호출하여 등록 [GetTaxCertURL - 인증서 등록 팝업 URL]
다른 사업자 정보로 테스트를 할 수 없나요?연동신청한 사업자 정보가 아닌 다른 사업자 정보로 테스트 하기 위해서는 팝빌 테스트 환경 계정 생성(회원가입)이 필요합니다. 아래 방법으로 팝빌 테스트 계정을 생성하고 사업자의 인증서를 등록하여 테스트 진행이 가능합니다.
- 팝빌 테스트 사이트 : "연동회원" 선택 [회원가입]
- API : [JoinMember - 연동회원 신규가입]사업자의 인증서를 등록하지 못할 때는 어떻게 테스트 하나요?- 사업자 공동인증서를 등록할 수 없는 경우 팝빌에서는 테스트용 가상 사업자 계정에서 사용 가능한 인증서를 지원합니다.
- 가상 사업자정보(사업자번호: 123-45-67890)로 테스트 계정을 생성하고, 팝빌에서 제공받은 테스트 인증서를 등록합니다.
- 테스트 인증서는 프로그램 공급사의 연동개발 편의를 위하여 제공하는 용도로 외부에 유출되지 않도록 유의하시기 바랍니다.
-
팝빌 사이트 등록
-
개발 테스트 : 개발에 필요한 테스트포인트를 무료 제공합니다.
API Key 를 설정한 SDK와 연동 문서를 참고하여 모든 API 테스트가 가능합니다. 팝빌은 테스트포인트를 무료(일부 제한)로 제공하며, 포인트를 모두 소진한 경우 추가 요청도 가능합니다. [포인트 요청]
- 튜토리얼
- SDK 예제
-
팝빌 운영(Production) 환경 서비스 전환 : 전환 요청 당일 즉시 서비스 이용이 가능합니다.
- 1) 테스트가 완료된 후 팝빌 운영(Production) 환경으로 서비스 전환을 신청합니다. [운영(PROD) 전환신청]
- 2) 팝빌 운영(Production) 환경 전환을 위한 협의사항을 팝빌 담당자와 유선으로 확인합니다.
-
3) 팝빌로부터 전환 완료 메일 수신한 후 SDK 환경설정 변수값을 변경합니다.
- API Key 는 팝빌 테스트 환경와 팝빌 운영(Production) 환경에서 동일하게 적용되어 별도 운영용 API Key 발급이 필요하지 않습니다.
- 전환 후에도 SDK 환경설정 변수로 팝빌 테스트 환경와 팝빌 운영(Production) 환경을 모두 이용할 수 있습니다.
SDK 환경설정 변경SDK의 서비스 객체를 생성하는 config 의 IsTest값을 "true"(테스트)에서 "false"(운영)로 변경합니다. [SDK 환경설정]
- 4) 팝빌 운영(Production) 환경 회원가입 및 서비스 이용을 위한 사전 준비사항(인증서 등록, 포인트 충전 등)을 처리합니다.
팝빌 테스트 환경은 팝빌 운영(Production) 환경과 독립적으로 구성되어, 가입된 계정 및 등록된 인증서는 팝빌 운영(Production) 환경에 이관되지 않습니다.