자주 묻는 질문

팝빌 API 상품을 도입·연동하기 전에 확인해야 할 주요 사항과, 연동 과정에서 자주 문의되는 내용을 안내합니다.

공통

API 연동에 기본료나 도입비용이 있나요?

없습니다. 테스트 환경은 무료 포인트로 제공되며, 실제 서비스 이용 시에만 요금이 발생합니다.
프로그램을 연동하여 고객사에 팝빌 API를 제공할 수 있나요?

네, 가능합니다. 단, 고객사가 팝빌에 파트너의 연동회원으로 가입해야 합니다.
팝빌에서는 프로그램 공급사를 '파트너', 파트너의 프로그램을 이용하는 고객사를 '연동회원'이라고 하며, 파트너가 제공하는 프로그램에서 팝빌 API를 사용하기 위해서는 고객사의 연동회원 가입이 필요합니다. [회원 구조]
테스트 환경에서도 사전 준비가 필요한가요?

네, 필요합니다. 팝빌 테스트 환경은 운영 환경과 동일하게 동작하므로, 사전 준비를 완료한 후에 테스트를 진행할 수 있습니다.
또한 팝빌 테스트 환경에 등록된 정보는 운영 환경과 동기화되지 않으며, 서로 독립적으로 관리됩니다.
테스트 포인트가 부족합니다. 추가로 지원받을 수 있나요?

네, 테스트 포인트가 소진된 경우 추가 신청을 통해 지원받을 수 있습니다. 테스트 환경에서는 팝빌이 제공하는 포인트로 개발을 진행하며, 포인트가 소진되면 팝빌에 테스트 포인트를 신청하여 계속 테스트할 수 있습니다.
단, 원가가 발생하는 일부 서비스는 포인트 지원이 제한될 수 있습니다. [테스트 포인트 신청]
운영(Production) 환경에서 테스트 환경으로 전환할 수 있나요?

네, 가능합니다. 설정 변경을 통해 테스트 환경과 운영 환경을 자유롭게 전환할 수 있습니다.
* SDK 레퍼런스 - SDK 설정값(IsTest)을 변경합니다. [SDK 환경설정]
* API 레퍼런스 - 도메인 및 ServiceID를 변경합니다. [API 환경설정]
“호출한 API 상품에 이용 권한이 부여되지 않아 사용이 제한됩니다.” 오류 메시지가 응답 되었습니다. 어떻게 조치해야 하나요?

네, 해당 오류는 호출한 API 상품이 미등록된 경우 발생합니다.
추가로 API 상품 테스트 또는 사용이 필요한 경우, 연동문의를 통해 상품 추가를 요청해 주시기 바랍니다. [연동 문의]
팝빌 SDK 외에 기술 문서를 제공받을 수 있나요?

네, 제공받을 수 있습니다.
팝빌 SDK 사용이 어려운 환경에서는 직접 구현하실 수 있도록 API 레퍼런스가 제공됩니다. [API 레퍼런스]

계좌조회

고객의 입금한 금액에 대하여 자동 승인 기능을 구현하고 싶습니다. 실시간으로 계좌 내역 조회가 가능할까요?

팝빌 계좌조회 조회주기는 30분, 20분, 10분, 5분, 3분 실시간까지 다양하게 제공하고 있으며, 선택한 조회 주기에 따라 요금이 달라집니다. 등록 계좌 개수가 10개를 초과하는 경우에는 할인도 함께 지원하고 있습니다. [계좌조회 요금 문의]
공동인증서를 사용하지 않고 계좌를 조회할 수 있는 방법이 있나요?

팝빌 계좌조회 서비스는 공동인증서를 사용하지 않고, 계좌 개설 은행에서 제공하는 "빠른조회 서비스"를 신청하여 계좌조회를 이용할 수 있습니다.
빠른조회 서비스는 은행에 따라 즉시조회, 스피드조회, 간편계좌조회 등 다양한 명칭으로 운영되며, 은행별 신청방법은 아래를 참고해 주시기 바랍니다. [은행별 빠른조회 신청방법]
외화계좌의 입출금 내역을 확인할 수 있나요?

팝빌 계좌조회 서비스는 일반 계좌(원화)의 입출금 내역만 조회를 지원하며, 외화계좌는 조회가 불가능합니다.
또한 외화계좌 외에도 적금·예금계좌, 신탁계좌 등 특수 용도의 계좌도 조회가 불가하니 참고해 주시기 바랍니다.
계좌조회 API 연동을 위한 테스트를 지원하나요?

팝빌 계좌조회 API 연동 테스트는 1개월간 무상으로 제공됩니다.
또한 팝빌 테스트 환경은 더미 데이터를 제공하는 타사와 달리, 실제 은행 거래 정보를 수집하여 제공하고 있습니다.
추가 테스트 기간이 필요한 경우에는 팝빌과 협의해 주시기 바랍니다.
입출금내역 조회 외에 송금(이체)도 가능한가요?

송금(이체)는 불가능합니다. 팝빌 계좌조회 API 이용을 위해 신청하는 “빠른조회 서비스”는 이체 기능을 지원하지 않으며, 거래내역 및 잔액 조회만을 목적으로 사용할 수 있습니다.
은행에서는 입출금 내역이 확인되지만, API로 조회시 거래내역이 업데이트 되지 않습니다.

팝빌은 프로그램 공급사에 계좌조회 지원 시 사전에 협의한 조회 주기를 기준으로 입출금 내역을 업데이트 하여 제공합니다.
조회 주기가 도래하기 전에 조회하면, 이전 조회 주기 내 마지막으로 성공한 조회 시점까지의 거래내역만 반환됩니다.
단, 조회 주기와 무관하게 특정 시간대의 입출금 내역이 계속 조회되지 않는 경우 파트너센터로 문의 주시기 바랍니다. [연동 문의]
최대 조회 가능한 계좌조회 기간은 언제인가요?

최대 조회 가능한 기간은 현재일로부터 과거 3개월 이내이며, 1회 조회시 최대 1개월 단위로만 조회할 수 있습니다.
3개월을 초과하는 거래내역 확인이 필요한 경우에는, 매월 조회한 거래내역을 내부 DB에 저장하여 별도로 조회해 주셔야 합니다.

기타

팝빌 API 사용 시 IP 또는 방화벽 등록이 필요한가요?

기본적으로 팝빌 API 사용에 있어 IP 또는 방화벽 등록은 필수 사항이 아닙니다.
단, 고객사의 보안정책(방화벽 등)으로 고정 IP 설정이 필요한 경우 아래와 같이 설정할 수 있습니다.
· SDK Reference - [UseStaticIP : 통신 IP 고정(방화벽)] 설정
· API Reference - [공통 정의 사항] Base URL을 고정IP 주소로 변경
또한 고객사 Source IP에 대한 [IP Whitelisting] 를 설정하여 보안을 강화할 수 있습니다.