자주 묻는 질문

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

공통

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

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

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

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

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

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

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

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

예금주조회

예금주조회를 유효성 검증용으로 사용 가능한가요?

네, 가능합니다. 팝빌에서 반환된 예금주명을 고객사에서 취득한 예금주명과 비교하여 유효성 검증용으로 사용 가능합니다.
단, 예금주명 길이는 은행사마다 상이하여 일부 글자가 잘려 반환될 수 있으므로, 전체 일치 여부보다는 팝빌에서 반환된 예금주명의 포함여부를 기준으로 정합성을 검증하는 것을 권장드립니다.
예금주명 외에도 계좌의 상태 확인이 가능한가요?

일부 은행의 경우 예금주 조회 시 계좌 상태 정보를 함께 반환하여, 정지 계좌나 거래 제한 계좌 여부 등을 확인할 수 있습니다.
단, 은행사 또는 계좌별로 반환되는 정보가 상이하여, 정지된 계좌라 하더라도 계좌 상태와 관계없이 예금주명이 반환될 수 있습니다.
예금주조회 정보를 팝빌에 보관하지 않고 삭제할 수 있나요?

네, 가능합니다. 팝빌은 고객사의 민감정보 유출 위험을 최소화하기 위해 예금주조회 정보 "즉시삭제" 기능을 제공하고 있습니다.
예금주조회 결과 제공과 동시에 계좌번호, 예금주명 등 민감정보를 팝빌 시스템에서 식별이 불가능 하도록 가명(마스킹) 처리하며, 해당 기능을 원하시는 경우 파트너센터로 접수하여 주시기 바랍니다. [예금주조회 민감정보 즉시삭제 문의]
은행 정기점검 시간에도 예금주조회 서비스 이용이 가능한가요?

은행 정기점검 시간인 23시 30분에서 00시 30분까지는 팝빌 예금주조회 서비스를 이용할 수 없습니다.
대부분의 은행은 이용 빈도가 가장 적은 시간대인 자정(24:00) 무렵에 점검을 진행하며, 점검 시간동안 타 은행과 연결되는 은행 공동망이 중단되어 조회 요청이 실패(201)로 반환됩니다.
성명조회(단건조회)와 실명조회(단건조회)로도 대량 조회가 가능한가요?

네, 가능합니다. 팝빌은 예금주 조회 1건 당 약 0.5초 소요되어, 별도의 조회 주기 제한없이 단건 조회 API를 반복 호출하는 방식으로 대량 조회가 가능합니다.
단, 빠른 조회 결과 반환을 위해 팝빌에서는 5개의 스레드를 사용해 동기식으로 API를 호출하는 방식으로 구현하는 것을 권장합니다.
동일한 계좌에 대하여 예금주조회 결과가 다릅니다.

팝빌은 안정적인 서비스 제공을 위하여 예금주조회 라인을 이중화하여 운영하고 있으며, 조회기관에 따라 예금주명이 다르게 반환될 수 있습니다. 또한 금융기관에서 자체 서비스(인터넷뱅킹, 앱 등)와 예금주조회 API는 조회방식이 달라, 동일 계좌라도 반환되는 결과에 차이가 발생할 수 있습니다.
예금주조회 API 조회결과 글자가 일부 잘려서 반환됩니다.

팝빌은 은행으로부터 반환받은 예금주 정보를 가공없이 제공하고 있어, 금융기관별로 예금주명 길이 제한 차이로 인해 글자가 잘려서 반환될 수 있습니다.
예금주조회를 유효성 검증 용도로 사용하는 경우, 예금주명을 완전 일치 기준이 아닌 해당 계좌 예금주명에 해당 글자가 포함되는지 여부로 정합성을 검증하는 것을 권장합니다.
개인사업자 계좌인데 사업자번호로 조회하면 결과가 반환되지 않습니다.

개인사업자 계좌는 통장 발급 시 사업자번호 또는 대표자 생년월일 중 선택하여 개설할 수 있습니다.
이 때문에 사업자번호로 조회가 되지 않는 경우에는, 대표자의 생년월일을 입력하여 조회해야 합니다.

기타

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

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