자주 묻는 질문
팝빌 API 상품을 도입·연동하기 전에 확인해야 할 주요 사항과, 연동 과정에서 자주 문의되는 내용을 안내합니다.
공통
-
API 연동에 기본료나 도입비용이 있나요?
없습니다. 테스트 환경은 무료 포인트로 제공되며, 실제 서비스 이용 시에만 요금이 발생합니다.
-
프로그램을 연동하여 고객사에 팝빌 API를 제공할 수 있나요?
네, 가능합니다. 단, 고객사가 팝빌에 파트너의 연동회원으로 가입해야 합니다.
팝빌에서는 프로그램 공급사를 '파트너', 파트너의 프로그램을 이용하는 고객사를 '연동회원'이라고 하며, 파트너가 제공하는 프로그램에서 팝빌 API를 사용하기 위해서는 고객사의 연동회원 가입이 필요합니다. [회원 구조]
-
테스트 환경에서도 사전 준비가 필요한가요?
네, 필요합니다. 팝빌 테스트 환경은 운영 환경과 동일하게 동작하므로, 사전 준비를 완료한 후에 테스트를 진행할 수 있습니다.
또한 팝빌 테스트 환경에 등록된 정보는 운영 환경과 동기화되지 않으며, 서로 독립적으로 관리됩니다. -
테스트 포인트가 부족합니다. 추가로 지원받을 수 있나요?
네, 테스트 포인트가 소진된 경우 추가 신청을 통해 지원받을 수 있습니다. 테스트 환경에서는 팝빌이 제공하는 포인트로 개발을 진행하며, 포인트가 소진되면 팝빌에 테스트 포인트를 신청하여 계속 테스트할 수 있습니다.
단, 원가가 발생하는 일부 서비스는 포인트 지원이 제한될 수 있습니다. [테스트 포인트 신청] -
운영(Production) 환경에서 테스트 환경으로 전환할 수 있나요?
네, 가능합니다. 설정 변경을 통해 테스트 환경과 운영 환경을 자유롭게 전환할 수 있습니다.
* SDK 레퍼런스 - SDK 설정값(IsTest)을 변경합니다. [SDK 환경설정]
* API 레퍼런스 - 도메인 및 ServiceID를 변경합니다. [API 환경설정]
-
“호출한 API 상품에 이용 권한이 부여되지 않아 사용이 제한됩니다.” 오류 메시지가 응답 되었습니다. 어떻게 조치해야 하나요?
네, 해당 오류는 호출한 API 상품이 미등록된 경우 발생합니다.
추가로 API 상품 테스트 또는 사용이 필요한 경우, 연동문의를 통해 상품 추가를 요청해 주시기 바랍니다. [연동 문의] -
팝빌 SDK 외에 기술 문서를 제공받을 수 있나요?
네, 제공받을 수 있습니다.
팝빌 SDK 사용이 어려운 환경에서는 직접 구현하실 수 있도록 API 레퍼런스가 제공됩니다. [API 레퍼런스]
홈택스수집
-
홈택스에 신고된 매출/매입 내역 수집을 자동화할 수 있나요?
네, 가능합니다.
웹훅(Webhook) 또는 팝빌 API 방식을 이용하여 홈택스 신고내역 수집을 자동화할 수 있습니다. [Webhook] * 웹훅(Webhook) - 팝빌이 홈택스 신고내역을 정기적(1시간 간격)으로 자동 수집하여, 고객사에게 서버로 전달하는 방식
* 팝빌 API - 고객사가 직접 API 호출하여 홈택스 신고내역을 수집하는 방식으로 주기적으로 API를 호출하도록 자동화 로직 구현 필요 -
홈택스에서 수집 가능한 정보는 무엇인가요?
홈택스에 신고된 전자세금계산서와 현금영수증의 모든 매입/매출 내역 정보를 수집할 수 있습니다.
* 전자세금계산서 - 매입/매출 전자세금계산서 60개 항목
* 현금영수증 - 매입/매출 현금영수증 18개 항목 -
홈택스에 신고된 전자세금계선서/현금영수증 내역 수집에 기간에 제한이 있나요?
네, 별도의 기간 제한은 없습니다.
팝빌 홈택스수집 서비스는 홈택스에 신고된 내역을 자유롭게 수집할 수 있으며, 최대 3개월 단위로 수집 요청을 진행하시면 됩니다.
단, 수집량은 실시간으로 모니터링되며 협의된 범위를 초과할 경우 비정상적인 이용으로 간주되어 제한이 발생할 수 있습니다. -
홈택스수집 API 연동을 위한 테스트를 지원하나요?
네, 지원합니다.
연동 테스트는 1개월간 무상으로 제공되며, 더미 데이터가 아닌 실제 홈택스에 신고된 정보를 수집하여 제공합니다.
추가 테스트 기간이 필요한 경우 파트너센터로 접수하여 주시면 협의후 지원 드리고 있습니다. [연동 문의] -
홈택스에서 수집된 내역의 정합성(누락/중복 등) 확보가 가능한가요?
네, 가능합니다.
홈택스수집 방식 중 하나인 웹훅(Webhhook)은 팝빌의 알고리즘을 통해 홈택스 신고 내역과 수집된 정보 간의 누락 및 중복을 제거하여 정합성을 보장합니다.
또한 고객사가 팝빌 API 방식으로 수집하는 경우에도 정합성 확보 방법을 가이드하여 지원해드리고 있습니다.
기타
-
팝빌 API 사용 시 IP 또는 방화벽 등록이 필요한가요?
기본적으로 팝빌 API 사용에 있어 IP 또는 방화벽 등록은 필수 사항이 아닙니다.
단, 고객사의 보안정책(방화벽 등)으로 고정 IP 설정이 필요한 경우 아래와 같이 설정할 수 있습니다.
· SDK Reference - [UseStaticIP : 통신 IP 고정(방화벽)] 설정
· API Reference - [공통 정의 사항] Base URL을 고정IP 주소로 변경
또한 고객사 Source IP에 대한 [IP Whitelisting] 를 설정하여 보안을 강화할 수 있습니다.
