회원구조

팝빌 API는 다음의 회원 구조를 기반으로 이용할 수 있습니다.

팝빌의 회원 구조는 프로그램 공급사를 파트너로 정의하고, 파트너 하위에 사업자등록번호 기준의 회원을 다수로 등록하여 관리할 수 있도록 구성되어 있습니다. 각 회원 하위에는 복수의 담당자 계정을 생성할 수 있으며, 담당자 계정을 인증 주체로 하여 API를 호출하고 서비스를 이용합니다.

파트너

파트너는 팝빌 API를 연동하여 자체 서비스 또는 시스템을 통해 제공하는 프로그램 공급사입니다.
팝빌 API 이용에 있어 최상위 관리 주체로서, 하나의 파트너 계정 하위에 다수의 회원을 등록하여 관리할 수 있습니다.

파트너는 다음과 같은 역할을 수행합니다.

팝빌 API 연동 및 기술 구현
연동회원(사업자등록번호 기준) 등록 및 관리
API Key(LinkID, SecretKey) 관리
연동회원 단위 API 상품 제공 및 운영 관리

팝빌 파트너관리자 사이트(https://partner.popbill.com)

파트너는 연동신청 시 입력한 계정정보(ID/PW)로 팝빌 테스트 환경과 운영 환경에 자동으로 가입됩니다. [연동신청]

연동회원

연동회원은 파트너가 제공하는 서비스를 이용하는 사업자 단위의 이용 주체로, 사업자등록번호 기준으로 관리되어 중복 등록은 불가합니다.

회원은 다음과 같은 특성을 가집니다.

파트너 하위에 소속된 사업자 단위 계정
사업자등록번호 기준의 서비스 이용 주체
세금계산서, 현금영수증 등 API 서비스 이용 대상
담당자 계정을 통해 API 이용 및 서비스 관리 수행

연동회원이 다수이거나 파트너 시스템에서 연동회원 가입을 처리하는 경우 API 방식 이용을 권장합니다.

담당자

담당자는 회원 하위에 생성되는 계정 단위의 실행 주체로, 팝빌 API 호출 및 서비스 이용을 수행합니다.

담당자는 다음과 같은 역할을 가집니다.

팝빌 API 호출 시 인증 주체
회원의 서비스 이용 및 설정 관리 수행
필요에 따라 복수 계정 생성 가능
개발 환경 및 연동 방식에 따라 필수가 아닌 경우도 존재

담당자가 다수이거나 파트너 시스템에서 담당자 추가를 처리하는 경우 API 방식 이용을 권장합니다.

역할

구분	설명
관리자(기본 생성)	담당자 추가/삭제, 권한 변경 등 전체 계정 관리가 가능 (단, 회사 권한만 부여 가능)
담당자(추가 생성)	관리자가 추가로 등록한 계정으로, 지정된 권한 범위에서 서비스 이용 및 데이터 조회 가능

권한

구분	설명
회사	연동회원의 모든 담당자가 처리한 정보를 조회하고 관리할 수 있는 권한
읽기	연동회원의 모든 담당자가 처리한 정보를 조회만 할 수 있는 권한
개인	담당자 본인이 처리한 정보만 조회 및 관리할 수 있는 권한