자주 묻는 질문

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

공통

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

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

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

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

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

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

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

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

팩스

팩스 전송을 위해서 발신번호를 사전에 필수로 등록해야 하나요?

팩스 전송 시 발신번호를 팝빌에 사전등록하지 않아도 전송은 가능합니다. 발신번호가 등록되어 있지 않는 경우 통신사로부터 부여받은 원발신번호로 전송됩니다.
단, 원발신번호는 다수가 이용하는 공용번호 이므로, 수신자가 스팸 또는 어뷰징으로 인식해 수신 차단할 가능성이 있어 팩스 수신율이 낮아질 수 있어 안정적인 발송을 위해 팝빌에 발신번호를 등록하여 팩스를 전송하실 것을 권장합니다. [팩스 발신번호 사전등록]
10만건 이상의 팩스를 한번에 전송이 가능하나요?

네, 가능합니다. 팝빌은 자체 개발한 메시지 자동분배 시스템을 이용하여 수백만 장의 팩스도 안정적으로 전송할 수 있습니다.
대량으로 유입된 팩스를 팝빌이 보유한 다수의 전송 라인에 자동으로 분배하여 빠르게 처리하며, 동일한 팩스를 다수의 수신처에 효율적으로 전송하는 동보전송 기능과 실패 건을 다시 보내는 재전송 기능도 함께 제공합니다.
팝빌의 팩스 재전송 정책이 어떻게 되나요?

팝빌에서는 팩스 수신율을 높이기 위해 전송 실패 건에 한해 통신사를 변경하여 최대 3회까지 자동 재전송을 시도합니다.
3회 재전송 이후에도 수신자에게 도달하지 못한 팩스는 전송실패 상태로 처리됩니다.
팩스 웹훅(Webhook) 서비스를 지원하나요?

네, 지원합니다. 팝빌은 팩스 전송 결과 및 상태 변경 시점에 고객사 서버로 정보를 실시간 자동 전달하는 웹훅(Outgoing Webhook) 서비스를 무료로 제공합니다.
이를 통해 상태 확인을 위한 반복적인 API 호출을 줄여 리소스를 절감할 수 있으며, 고객사의 개발 소요시간을 낮추고 시스템 운영 효율을 높일 수 있습니다. [<업계유일>팝빌 팩스 Webhook]
전송된 팩스 정보를 팝빌에 남기지 않고 삭제할 수 있나요?

네, 가능합니다. 팝빌은 고객사의 민감정보 유출 위험을 최소화하기 위해 전송된 팩스 파일 "즉시삭제" 기능을 제공하고 있습니다.
이 기능을 적용하면 통신사 전송 시점에 팝빌이 보관하는 팩스 파일이 즉시 삭제됩니다. [팩스 즉시삭제 문의]
팩스 예약 전송도 가능한가요?

네, 팝빌은 팩스 예약 전송을 지원합니다. 전송 요청 시 메시지 유형에 ReserveDT(전송 예약일시) 값을 입력해 주시기 바랍니다.
단, 예약 전송은 접수일시 기준 최대 1년 이내의 날짜만 설정할 수 있습니다.
대기 상태의 접수가 완료된 팩스를 취소도 가능한가요?

접수가 완료된 팩스는 전송 취소가 불가합니다.
단, 예약 전송 건은 예약일시 10분 전까지 취소할 수 있습니다.
팩스 상태가 “접수(0)” 상태로 전송이 10분 넘게 지연되고 있습니다.

접수 상태에서 전송이 지연되는 경우는 다음의 사유가 있을 수 있으며, 접수 상태에서 재전송은 중복 발송으로 이어질 수 있으니 주의해 주시기 바랍니다.
- 수신처 통화중: 즉시 실패 처리되지 않으며, 5분 간격으로 총 3회 재시도 후 실패 처리됩니다.
- 전송 페이지 수/전송량 증가: 한 번에 보내는 장수가 많거나, 전송이 몰리는 시간대에는 지연될 수 있습니다.
- 원본 품질(명암/컬러 스캔): 스캔 시 빛 반사·명암이 많거나 컬러 스캔 파일인 경우 변환 처리 시간이 늘어나 지연될 수 있습니다.

기타

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

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