자주하는 질문

1. API 를 테스트하고 싶습니다. 테스트에 필요한 절차가 어떻게 되나요?

팝빌 API 서비스를 테스트하기 위해서는 서비스 연동신청이 필요합니다.
연동신청이 승인되면 담당자의 메일로 인증정보를 발급해드립니다. 발급된 인증정보를 통해 SDK Example 코드를 테스트할 수 있습니다.
- 팝빌 연동신청 https://www.popbill.com/Content/Form

2. API 를 직접 구현해야 하나요?

팝빌 서비스 API를 구현한 언어별 SDK가 지원되며, 개발을 진행하실 때는 언어별 SDK에 정의된 함수 호출을 통해 기능을 구현할 수 있습니다.
Java, PHP, .Net, Node.js, Python, ASP, Delphi, PowerBuilder, Visual Basic6, VBA, Ruby, SAP ERP를 지원하고 있습니다.
- 팝빌 연동자료실 https://www.popbill.com/Content/SDK

3. API 호출에 대한 호출횟수 또는 동시처리에 대한 제한이 있나요?

API 호출에 대한 사용회수 또는 동시처리에 대한 제한은 없습니다.
서버에 부하를 발생시키는 의도적인 공격에 대해서는 모니터링을 통해 IP를 제한하고 있습니다.

4. API 를 통해 주고받는 요청/응답 전문은 암호화 되나요?

팝빌 API 서비스 기본적으로 TLS 암호화 통신을 기반으로 HMAC-SHA1 알고리즘이 적용되어 있습니다.
네트워크 스니핑(Sniffing), 스푸핑(Spoofing) 등 제 3자가 의도적으로 네트워크 패킷을 획득/변조 하더라도 보안에 문제가 발생하지 않도록 팝빌 API 서버에서는 OAuth 기반의 링크허브 인증, Bearer Token 인증이 적용되어 있습니다.

5. 호스팅 서버를 사용하고 있습니다. 팝빌 API를 이용할 수 있나요?

팝빌 API는 HTTP 통신이 가능한 모든 환경에서 이용 가능합니다.
팝빌에서 제공되는 SDK는 개발언어 자체의 HTTP 내장함수를 구현하여 별도의 모듈 설치나 라이브러리 설치 없이도 함수 기능을 이용할 수 있습니다. 호스팅 서버 보안정책상 아웃바운드 트래픽을 제한하는 서버환경에서도 팝빌 API 서버 IP를 화이트리스트에 등록하시면 문제없이 SDK를 이용할 수 있습니다.

6. 전자정부 프레임워크(eGovFrame)로 구현된 환경에서도 현금영수증 SDK를 이용할 수 있나요?

팝빌에서 제공하는 Java SDK는 Java 1.6 이상을 지원하며 언어 자체적으로 지원하는 내장클래스/함수를 기반으로 구현되었습니다.
버전 및 패키지 관리는 Maven을 통해 관리/제공되고 있습니다. 전자정부 프레임워크를 사용하는 환경에서도 Maven을 통해 편리하게 SDK를 프로젝트에 적용할 수 있습니다.
- Maven을 사용할 수 없는 환경에서도 jar 파일을 프로젝트에 import 하는 방식으로 구현할 수 있습니다.

7. 모바일 어플리케이션을 개발중입니다. 현금영수증 기능을 구현할 수 있나요?

모바일 어플리케이션을 개발하는 경우 팝빌 현금영수증 API 기능을 처리할 서버를 구축하고 모바일 어플리케이션을 통해 작성된 현금영수증 정보를 서버로 전송하는 방식으로 구현할 수 있습니다.

구성 : 모바일 어플리케이션 ↔ AP 서버 ↔ 팝빌 API 서버

8. SDK 사용에 대한 기술지원을 받고 싶습니다. 어떤 방법이 있나요?

팝빌 기술지원센터에서는 각 언어별 전담 개발자들이 유선/메일/원격지원을 통해 연동개발을 지원하고 있습니다.
팝빌 기술지원센터 : T. 1600-9854 / E. code@linkhub.co.kr

9. 브라우저에서 URL을 호출하거나 Postman과 같이 HTTP Request를 호출해 테스트 할 수 없나요?

팝빌 API 서비스는 단순한 HTTP 호출로 처리되지 않고, 인증 토큰 발급, Bearer 토큰인증 등 보안과 관련된 기능이 구현되어 있기 때문에 단순한 HTTP Request를 통한 테스트는 불가합니다.
언어별 SDK는 인증 토큰 발급, Bearer 토큰인증 등 보안과 관련된 기능이 내부적으로 구현되어 SDK를 이용해 개발하는 과정에서는 단순하게 함수를 호출하는 방식으로 기능을 이용할 수 있습니다.

10. 도입을 검토중입니다. SDK를 사용할 때 비용을 지불하나요?

팝빌에서는 개발환경에서 테스트를 통해 발생하는 비용을 포인트를 통해 무료로 지원하고 있습니다.
지원된 포인트를 모두 소진하였을 경우 상황에 따라 충전처리가 필요할 수 있습니다.

11. 외부 네트워크와 차단된 내부망 환경입니다. API를 연동할 수 있나요?

외부 네트워크와 차단된 내부망 환경에서 외부연결이 가능한 DMZ존에 Proxy 서버를 세팅하여 API를 호출할 수 있습니다.
Proxy 환경을 구현한 파트너사의 사례들이 많이 있으며 Proxy 구축 가이드 문서와 함께 기술지원센터에서 기술지원을 도와드리고 있습니다.

12. SDK 함수 호출시 "링크아이디에 사용 가능한 아이피주소가 아닙니다." 오류가 발생합니다.

해당 오류는 연동신청시에 메일로 발급해드린 인증정보(링크아이디, 비밀번호)를 SDK 예제코드에서 변경하지 않고 SDK 예제코드의 함수를 호출하였을 때 발생합니다.
인증정보에 대한 변수값을 변경하였는지 확인하고, 서버환경이라면 서버 애플리케이션에 적용을 위해 재시작 또는 리로드해주시기 바랍니다.

13. SDK 함수 호출시 "인증키와 사용자아이디로 사용자를 식별할 수 없습니다." 오류가 발생합니다.

해당 오류는 함수 파라미터로 기재된 '팝빌회원 아이디'가 올바르지 않은 경우에 발생합니다.
호출시에 기재된 팝빌회원 아이디가 회원가입시 기재한 정보화 일치하는지, 또는 파트너 신청시 메일로 발급해드린 인증정보에 포함된 '링크아이디' 를 '팝빌회원 아이디'에 기재하지 않도록 주의하시기 바랍니다.

14. 현금영수증 API 비용을 알고 싶습니다.

팝빌 현금영수증 API는 무료로 제공됩니다 연동 신청 문의는 파트너센터로 연락하여 주시기 바랍니다.
파트너센터 : T. 1600-8536 / E. sales@linkhub.co.kr

15. SDK 호출을 통해 테스트한 현금영수증은 어디서 확인할 수 있나요?

SDK를 통해 발행한 현금영수증은 팝빌 개발환경 사이트에서 확인할 수 있습니다.
개발환경 사이트에 로그인하여 상단의 [현금영수증] 메뉴에서 현금영수증 정보를 확인할 수 있습니다.
- 팝빌 개발환경 https://test.popbill.com

16. 현금영수증의 메일, 문자, 팩스 전송 기능 이용시 포인트가 차감되나요?

현금영수증 부가적인 기능 함수로 제공되는 메일 전송(SendEmail API) 기능은 포인트가 소진되지 않습니다.
문자 전송(SendSMS API), 팩스 전송(SendFAX API) 기능은 사용건수에 따라 포인트가 차감됩니다.

17. 현금영수증 뿐만 아니라 다른 서비스도 테스트하고 싶습니다 어떻게 해야 하나요?

현금영수증 SDK를 연동하셨다면, 유사한 함수 패턴과 로직으로 구현된 팝빌의 다른 서비스 테스트 및 기능 구현이 보다 수월합니다.
API 서비스 이용을 위한 사전설정이 필요하므로 파트너센터로 연락주시기 바랍니다.
파트너센터 : T. 1600-8536 / E. sales@linkhub.co.kr

18. 현금영수증 SDK 기능 개발을 완료하였습니다. 상업용 전환은 어떻게 진행하나요?

상업용 전환은 파트너센터에서 진행을 도와드리고 있습니다. 아래의 연락처로 연락주시기 바랍니다.
파트너센터 : T. 1600-8536 / E. sales@linkhub.co.kr

19. 팝빌 SDK를 업데이트 하더라도 기존에 구현한 함수는 영향이 없나요?

팝빌 API 서비스의 언어별 SDK는 github을 통해 공개되어 있으며, 버전관리 및 하위호환성을 보장하고 있습니다.
공개된 자료는 아래의 github 링크를 참조하시기 바랍니다.
- 팝빌 SDK Github https://github.com/linkhub-sdk/