회원 관리

1. CheckIsMember - 연동회원 가입여부 확인

GET https://popbill-test.linkhub.co.kr/Join

GET https://popbill.linkhub.co.kr/Join

사업자번호를 조회하여 연동회원 가입여부를 확인합니다.

Request

요청 헤더

순번	변수명	필수	설명
	Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
	Accept-Encoding	N	응답 압축 방식 gzip

Query 파라미터

순번	변수명	타입	길이	필수	설명
	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	LID	string	-	Y	팝빌에서 발급한 링크아이디

요청 예시

curl --request GET \
  --url 'https://{domain}/Join?CorpNum={CorpNum}&LID={LID}'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 0미가입 1가입
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "가입"
}

2. CheckID - 연동회원 아이디 중복 확인

GET https://popbill-test.linkhub.co.kr/IDCheck

GET https://popbill.linkhub.co.kr/IDCheck

사용하고자 하는 아이디의 중복여부를 확인합니다.

Request

요청 헤더

순번	변수명	필수	설명
	Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
	Accept-Encoding	N	응답 압축 방식 gzip

Query 파라미터

순번	변수명	타입	길이	필수	설명
	ID	string	50	Y	중복여부를 확인할 아이디

요청 예시

curl --request GET \
  --url 'https://{domain}/IDCheck?ID={ID}'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 0미사용 1사용
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "해당아이디는 사용중 입니다."
}

3. JoinMember - 연동회원 신규가입

POST https://popbill-test.linkhub.co.kr/Join

POST https://popbill.linkhub.co.kr/Join

프로그램 공급사의 고객사를 팝빌 연동회원으로 가입하는 API 입니다.

회원의 정보가 현행화 되지 않은 경우 연동회원 신규가입 API 사용이 제한될 수 있으니 유의하시기 바랍니다.

Request

요청 헤더

변수명	필수	설명
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip

요청 본문

변수명	타입	길이	필수	설명
ID	string	50	Y	아이디 6자 이상 50자 이하
Password	string	50	Y	비밀번호 8자 이상 20자 이하 영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
LinkID	string	20	Y	파트너 링크아이디 팝빌에서 발급한 링크아이디
CorpNum	string	10	Y	사업자번호 ('-' 제외)
CEOName	string	100	Y	대표자 성명
CorpName	string	200	Y	회사명
Addr	string	300	Y	사업장 주소
BizType	string	100	Y	업태
BizClass	string	100	Y	종목
ContactName	string	100	Y	담당자 성명
ContactEmail	string	100	Y	담당자 메일
ContactTEL	string	20	Y	담당자 휴대폰

요청 예시

curl --request POST \
  --url 'https://{domain}/Join' \
  --header 'Content-Type: application/json' \
  --data '{
    "ID": "test",
    "Password": "test",
    "LinkID": "TESTER",
    "CorpNum": "1234567890",
    "CEOName": "대표자명",
    "CorpName": "회사명",
    "Addr": "주소",
    "BizType": "업태",
    "BizClass": "종목",
    "ContactName": "담당자명",
    "ContactEmail": "test@test.com",
    "ContactTEL": "01012345678"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "가입 완료"
}

4. QuitMember - 연동회원 탈퇴

POST https://popbill-test.linkhub.co.kr/QuitRequest

POST https://popbill.linkhub.co.kr/QuitRequest

팝빌 연동회원을 탈퇴 처리합니다.

관리자를 포함한 모든 담당자가 일괄 삭제 처리됩니다.

잔여포인트가 존재하는 경우, [환불신청 → 회원탈퇴] 프로세스로 구현하시기를 권장합니다.
회원탈퇴 직후 동일 사업자번호 및 아이디로 재가입이 가능합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

순번	변수명	타입	길이	필수	설명
	quitReason	string	200	Y	회원 탈퇴 사유

요청 예시

curl --request POST \
  --url 'https://{domain}/QuitRequest' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "quitReason": "회원 탈퇴 사유"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "신청 완료"
}

5. GetCorpInfo - 회사정보 확인

GET https://popbill-test.linkhub.co.kr/CorpInfo

GET https://popbill.linkhub.co.kr/CorpInfo

연동회원의 회사정보를 확인합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 예시

curl --request GET \
  --url 'https://{domain}/CorpInfo'
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
ceoname	string	100	대표자 성명
corpName	string	200	회사명
addr	string	300	주소
bizType	string	100	업태
bizClass	string	100	종목

응답 예시

{
    "ceoname": "대표자명",
    "corpName": "회사명",
    "addr": "주소",
    "bizType": "업태",
    "bizClass": "종목"
}

6. UpdateCorpInfo - 회사정보 수정

POST https://popbill-test.linkhub.co.kr/CorpInfo

POST https://popbill.linkhub.co.kr/CorpInfo

연동회원의 회사정보를 수정합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

변수명	타입	길이	필수	설명
ceoname	string	100	Y	대표자 성명
corpName	string	200	Y	회사명
addr	string	300	Y	주소
bizType	string	100	Y	업태
bizClass	string	100	Y	종목

요청 예시

curl --request POST \
  --url 'https://{domain}/CorpInfo' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "ceoname": "대표자명",
    "corpName": "회사명",
    "addr": "주소",
    "bizType": "업태",
    "bizClass": "종목"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "수정 완료"
}

7. RegistContact - 담당자 추가

POST https://popbill-test.linkhub.co.kr/IDs/New

POST https://popbill.linkhub.co.kr/IDs/New

연동회원에 담당자를 추가합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

변수명	타입	길이	필수	설명
id	string	50	Y	아이디 6자 이상 50자 이하
password	string	20	Y	비밀번호 8자 이상 20자 이하 영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
personName	string	100	Y	담당자 성명
tel	string	20	Y	담당자 휴대폰
email	string	100	Y	담당자 메일
searchRole	number	1	N	권한 1개인권한 2읽기권한 3회사권한 : 기본값

요청 예시

curl --request POST \
  --url 'https://{domain}/IDs/New' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "test",
    "password": "test",
    "personName": "담당자명",
    "tel": "01012345678",
    "email": "test@test.com"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "추가 완료"
}

8. GetContactInfo - 담당자 정보 확인

POST https://popbill-test.linkhub.co.kr/Contact

POST https://popbill.linkhub.co.kr/Contact

연동회원에 추가된 담당자 정보를 확인합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

순번	변수명	타입	길이	필수	설명
	id	string	50	Y	담당자 아이디

요청 예시

curl --request POST \
  --url 'https://{domain}/Contact' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "test"
  }'

Response

응답 본문

변수명	타입	길이	설명
id	string	50	담당자 아이디
personName	string	100	담당자 성명
tel	string	20	담당자 휴대폰
email	string	100	담당자 메일
regDT	string	14	등록일시 형식 : yyyyMMddHHmmss
searchRole	number	1	권한 1개인권한 2읽기권한 3회사권한
mgrYN	boolean	-	역할 true관리자 false담당자 팝빌 사이트 [ 마이페이지 > 회사정보 > 담당자 관리 ] 메뉴에서 수정 가능
state	number	1	계정상태 1사용중

응답 예시

{
    "id": "test",
    "personName": "담당자명",
    "tel": "010-1234-5678",
    "email": "test@test.com",
    "regDT": "20250711112027",
    "mgrYN": true,
    "state": 1,
    "searchRole": 3
}

9. ListContact - 담당자 목록 확인

GET https://popbill-test.linkhub.co.kr/IDs

GET https://popbill.linkhub.co.kr/IDs

연동회원에 추가된 담당자 목록을 확인합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 예시

curl --request GET \
  --url 'https://{domain}/IDs' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
id	string	50	담당자 아이디
personName	string	100	담당자 성명
tel	string	20	담당자 휴대폰
email	string	100	담당자 메일
regDT	string	14	등록일시 형식 : yyyyMMddHHmmss
searchRole	number	1	권한 1개인권한 2읽기권한 3회사권한
mgrYN	boolean	-	역할 true관리자 false담당자 팝빌 사이트 [ 마이페이지 > 회사정보 > 담당자 관리 ] 메뉴에서 수정 가능
state	number	1	계정상태 1사용중

응답 예시

[
  {
      "id": "test",
      "personName": "담당자명",
      "tel": "010-1234-5678",
      "email": "test@test.com",
      "regDT": "20250711112027",
      "mgrYN": true,
      "state": 1,
      "searchRole": 3
  }
]

10. UpdateContact - 담당자 정보 수정

POST https://popbill-test.linkhub.co.kr/IDs

POST https://popbill.linkhub.co.kr/IDs

연동회원에 추가된 담당자 정보를 수정합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

변수명	타입	길이	필수	설명
id	string	50	Y	아이디 6자 이상 50자 이하
personName	string	100	Y	담당자 성명
tel	string	20	Y	담당자 휴대폰
email	string	100	Y	담당자 메일
searchRole	number	1	N	권한 1개인권한 2읽기권한 3회사권한 : 기본값

요청 예시

curl --request POST \
  --url 'https://{domain}/IDs' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "test",
    "personName": "담당자명",
    "tel": "01012345678",
    "email": "test@test.com",
    "searchRole": 3
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "수정 완료"
}

11. DeleteContact - 담당자 삭제

POST https://popbill-test.linkhub.co.kr/Contact/Delete

POST https://popbill.linkhub.co.kr/Contact/Delete

연동회원에 추가된 담당자를 삭제합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	Y	팝빌회원 아이디 관리자만 요청 가능

Query 파라미터

순번	변수명	타입	길이	필수	설명
	ContactID	string	50	Y	삭제할 담당자 아이디 관리자는 삭제 불가

요청 예시

curl --request POST \
  --url 'https://{domain}/Contact/Delete?ContactID={ContactID}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "삭제 완료"
}

12. GetAccessURL - 팝빌 로그인 팝업 URL

GET https://popbill-test.linkhub.co.kr/Member

GET https://popbill.linkhub.co.kr/Member

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	TG	string	-	Y	고정값 : LOGIN

요청 예시

curl --request GET \
  --url 'https://{domain}/Member?TG=LOGIN' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	url	string	-	팝빌 로그인 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/API?T=FFXMY6SEHFVDD27TUYBESQ7...XYK2NPF5NLWKD2==="
}