POPBill Developers
연동신청
  • 가이드 0
  • 레퍼런스 0
  • 오류코드 0
전자명세서
  • 전자세금계산서
  • 현금영수증
  • 전자명세서
  • 홈택스수집(세금)
  • 홈택스수집(현금)
  • 사업자등록상태조회
  • 기업정보조회
  • 계좌조회
  • 예금주조회
  • 카카오톡
  • 문자
  • 팩스
가이드

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK 레퍼런스

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

팝빌의
SDK 다운로드
API 레퍼런스

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

고객지원

API 연동 중 발생하는 문제는
팝빌에서 해결을 도와드립니다.

팝빌의
서비스 제안서 수많은 기업이
선택한 팝빌
API 레퍼런스
전자명세서
API 레퍼런스 전자명세서 포인트 관리

포인트 관리

1. GetUnitCost - 발행 단가 확인

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}
  • 전자명세서 발행시 과금되는 포인트 단가를 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
ItemCode number - Y 전자명세서 문서 유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
Query 파라미터
순번 변수명 타입 길이 필수 설명
cfg string - Y 고정값 : UNITCOST
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}?cfg=UNITCOST' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
unitCost string - 발행 단가
응답 예시
{
    "unitCost": "200"
}

2. GetChargeInfo - 과금정보 확인

GET https://popbill-test.linkhub.co.kr/Statement/ChargeInfo/{ItemCode}
GET https://popbill.linkhub.co.kr/Statement/ChargeInfo/{ItemCode}
  • 팝빌 전자명세서 API 서비스 과금정보를 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
ItemCode number - Y 전자명세서 문서 유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/ChargeInfo/{ItemCode}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
unitCost string 12 발행 단가
chargeMethod string 3 과금유형
연동
파트너
rateSystem string 3 과금제도
종량제
응답 예시
{
    "chargeMethod": "연동",
    "rateSystem": "종량제",
    "unitCost": "0"
}

3. GetBalance - 연동회원 잔여포인트 확인

GET https://auth.linkhub.co.kr/POPBILL_TEST/Point
GET https://auth.linkhub.co.kr/POPBILL/Point
  • 연동회원의 잔여포인트를 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/Point' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
remainPoint string - 연동회원 잔여포인트
defUsedPoint string - 후불사용 포인트
응답 예시
{
    "remainPoint": "84923",
    "defUsedPoint": "0"
}

4. GetChargeURL - 연동회원 포인트 충전 팝업 URL

GET https://popbill-test.linkhub.co.kr/Member
GET https://popbill.linkhub.co.kr/Member
  • 연동회원 포인트를 충전하는 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 800px / height = 700px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : CHRG
요청 예시
curl --request GET \
  --url 'https://{domain}/Member?TG=CHRG' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 연동회원 포인트 충전 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=G6IMAVA7FZXLUKPKVFXDJRYU5LSPRSGIWF...Q3RQDO6P6KLW6==="
}

5. PaymentRequest - 연동회원 무통장 입금신청

POST https://popbill-test.linkhub.co.kr/Payment
POST https://popbill.linkhub.co.kr/Payment
  • 연동회원 포인트 충전을 위해 무통장입금을 신청합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 본문
순번 변수명 타입 길이 필수 설명
settlerName string 100 N 담당자명
settlerEmail string 100 N 담당자 메일
notifyHP string 20 N 담당자 휴대폰
무통장 입금 승인 알림톡이 전송될 번호
paymentName string 70 Y 입금자명
settleCost string 18 Y 결제금액
요청 예시
curl --request POST \
  --url 'https://{domain}/IDs' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "settlerName": "담당자명",
    "settlerEmail": "test@test.com",
    "notifyHP": "01012345678",
    "paymentName": "입금자명",
    "settleCost": "110000"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "수정 완료"
}

6. GetSettleResult - 연동회원 무통장 입금신청 정보확인

GET https://popbill-test.linkhub.co.kr/Payment/{settleCode}
GET https://popbill.linkhub.co.kr/Payment/{settleCode}
  • 연동회원 포인트 무통장 입금신청내역 1건을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
settleCode string 18 Y 정산코드
팝빌에서 임의 할당하는 값으로 [PaymentRequest - 연동회원 무통장 입금신청] 호출시 반환되는 값
요청 예시
curl --request GET \
  --url 'https://{domain}/Payment/{settleCode}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
productType string 3 결제 내용
포인트
정액제
미수금
productName string 30 결제 상품명
settleType string 7 결제유형
무통장
신용카드
실시간계좌이체
settlerName string 100 담당자명
settlerEmail string 100 담당자 메일
settleCost string 18 결제금액
settlePoint string 18 충전포인트
settleState number 1 결제상태
  • 1대기
  • 2승인
  • 3실패
  • 45취소
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
stateDT string 14 상태일시
형식 : yyyyMMddHHmmss
응답 예시
{
    "productType": "포인트",
    "productName": "팝빌 포인트 충전",
    "settleType": "무통장",
    "settlerName": "담당자명",
    "settlerEmail": "test@test.com",
    "settleCost": "11000",
    "settlePoint": "10000",
    "settleState": 1,
    "regDT": "20251020092932",
    "stateDT": "20251020092932"
}

7. GetPaymentHistory - 연동회원 포인트 결제내역 확인

GET https://popbill-test.linkhub.co.kr/PaymentHistory
GET https://popbill.linkhub.co.kr/PaymentHistory
  • 연동회원의 포인트 결제내역을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
SDate string 8 Y 검색 시작일자
형식 : yyyyMMdd
EDate string 8 Y 검색 종료일자
형식 : yyyyMMdd
Page number - N 목록 페이지번호
기본값 : 1
PerPage number - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
요청 예시
curl --request GET \
  --url 'https://{domain}/PaymentHistory?SDate={SDate}&EDate={EDate}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list array - 결제내역
순번 변수명 타입 길이 설명
productType string 3 결제 내용
포인트
정액제
미수금
productName string 30 결제 상품명
settleType string 7 결제유형
무통장
신용카드
실시간계좌이체
settlerName string 100 담당자명
settlerEmail string 100 담당자 메일
settleCost string 18 결제금액
settlePoint string 18 충전포인트
settleState number 1 결제상태
  • 1대기
  • 2승인
  • 3실패
  • 45취소
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
stateDT string 14 상태일시
형식 : yyyyMMddHHmmss
응답 예시
{
    "code": 1,
    "total": 1,
    "perPage": 100,
    "pageNum": 1,
    "pageCount": 1,
    "list": [
        {
            "productType": "포인트",
            "productName": "팝빌 포인트 충전",
            "settleType": "무통장",
            "settlerName": "담당자명",
            "settlerEmail": "test@test.com",
            "settleCost": "11000",
            "settlePoint": "10000",
            "settleState": 1,
            "regDT": "20251020092932",
            "stateDT": "20251020092932"
        }
    ],
    "message": "검색 완료"
}

8. GetPaymentURL - 연동회원 포인트 결제내역 팝업 URL

GET https://popbill-test.linkhub.co.kr/Member
GET https://popbill.linkhub.co.kr/Member
  • 연동회원 포인트 결제내역 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : PAYMENT
요청 예시
curl --request GET \
  --url 'https://{domain}/Member?TG=PAYMENT' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 연동회원 포인트 결제내역 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=HUC5ZZQK4XZMN7KQFPJC7NMPHGKABA...47XLSGM2S7U6UORIQ="
}

9. GetUseHistory - 연동회원 포인트 사용내역 확인

GET https://popbill-test.linkhub.co.kr/UseHistory
GET https://popbill.linkhub.co.kr/UseHistory
  • 연동회원의 포인트 사용내역을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
SDate string 8 Y 검색 시작일자
형식 : yyyyMMdd
EDate string 8 Y 검색 종료일자
형식 : yyyyMMdd
Page number - N 목록 페이지번호
기본값 : 1
PerPage number - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
Order string 1 N 거래일자를 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
요청 예시
curl --request GET \
  --url 'https://{domain}/UseHistory?SDate={SDate}&EDate={EDate}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list array - 사용내역
순번 변수명 타입 길이 설명
itemCode string 3 서비스 코드
  • 110세금계산서
  • 111홈택스수집(세금)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
  • 140현금영수증
  • 141홈택스수집(현금)
  • 150문자(SMS)
  • 151문자(LMS)
  • 152문자(MMS)
  • 153알림톡
  • 160팩스(일반망)
  • 161팩스(지능망)
  • 170사업자등록상태조회
  • 171기업정보조회
  • 180계좌조회
  • 182성명조회
  • 183실명조회
txType string 2 포인트 증감 유형
포인트 증가
  • 11포인트 충전
  • 12조정
  • 13조정
  • 19분배
  • 31환불
  • 32정액제 해지
포인트 감소
  • 21서비스 사용
  • 22조정
  • 23조정
  • 24포인트 결제
  • 25미수금 결제
  • 26포인트 환불
  • 29회수
  • 41후불누적조정
txPoint string 18 증감 포인트
balance string 18 잔여 포인트
txDT string 14 포인트 증감 일시
형식 : yyyyMMddHHmmss
userID string 50 담당자 아이디
userName string 100 담당자명
응답 예시
{
    "code": 1,
    "total": 11,
    "perPage": 100,
    "pageNum": 1,
    "pageCount": 1,
    "list": [
        {
            "itemCode": 110,
            "txType": 21,
            "txPoint": "200",
            "balance": "84923",
            "txDT": "20251016151124",
            "serviceUserID": "025070000083",
            "userID": "testkorea",
            "userName": "담당자명"
        }
    ],
    "message": "검색 완료"
}

10. GetUseHistoryURL - 연동회원 포인트 사용내역 팝업 URL

GET https://popbill-test.linkhub.co.kr/Member
GET https://popbill.linkhub.co.kr/Member
  • 연동회원 포인트 사용내역 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : USEHISTORY
요청 예시
curl --request GET \
  --url 'https://{domain}/Member?TG=USEHISTORY' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 연동회원 포인트 사용내역 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=HUC5ZZQK4XZMN7KQFPJC7NMPHGKABA...47XLSGM2S7U6UORIQ="
}

11. Refund - 연동회원 포인트 환불신청

POST https://popbill-test.linkhub.co.kr/Refund
POST https://popbill.linkhub.co.kr/Refund
  • 연동회원 포인트를 환불 신청합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 본문
순번 변수명 타입 길이 필수 설명
contactname string 100 Y 담당자명
tel string 20 Y 담당자 연락처
requestpoint string 18 Y 환불 신청 포인트
accountbank string 10 Y 은행명
accountnum number 50 Y 계좌번호
accountname number 70 Y 예금주명
reason number 200 N 환불사유
요청 예시
curl --request POST \
  --url 'https://{domain}/Refund' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "contactname": "담당자명",
    "tel": "01012345678",
    "requestpoint": "1",
    "accountbank": "은행명",
    "accountnum": "계좌번호",
    "accountname": "예금주명",
    "reason": "환불사유"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
refundCode string 18 환불코드
응답 예시
{
    "code": 1,
    "message": "환불 신청완료",
    "refundCode": "025100000001"
}

12. GetRefundHistory - 연동회원 포인트 환불내역 확인

GET https://popbill-test.linkhub.co.kr/RefundHistory
GET https://popbill.linkhub.co.kr/RefundHistory
  • 연동회원의 포인트 환불신청내역을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
Page number - N 목록 페이지번호
기본값 : 1
PerPage number - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
요청 예시
curl --request GET \
  --url 'https://{domain}/RefundHistory' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list array - 결제내역
순번 변수명 타입 길이 설명
reqDT string 14 신청일시
형식 : yyyyMMddHHmmss
requestPoint string 18 환불 신청포인트
accountBank string 10 환불계좌 은행명
accountNum string 50 환불계좌번호
accountName string 70 환불계좌 예금주명
state number 1 상태
  • 1 접수대기
  • 2 심사중
  • 3 입금대기
  • 4 환불완료
  • 5 취소
reason string 200 환불사유
응답 예시
{
    "code": 1,
    "total": 2,
    "perPage": 100,
    "pageNum": 1,
    "pageCount": 1,
    "list": [
        {
            "reqDT": "20251020102118",
            "requestPoint": "1",
            "accountBank": "국민",
            "accountNum": "123123123-123",
            "accountName": "예금주명",
            "state": 1,
            "reason": "환불사유"
        }
    ],
    "message": "검색 완료"
}

13. GetPartnerBalance - 파트너 잔여포인트 확인

GET https://auth.linkhub.co.kr/POPBILL_TEST/PartnerPoint
GET https://auth.linkhub.co.kr/POPBILL/PartnerPoint
  • 파트너의 잔여포인트를 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/PartnerPoint' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
remainPoint string - 파트너 잔여포인트
defUsedPoint string - 후불사용 포인트
응답 예시
{
    "remainPoint": "32382",
    "defUsedPoint": "0"
}

14. GetPartnerURL - 파트너 포인트 충전 팝업 URL

GET https://auth.linkhub.co.kr/POPBILL_TEST/URL
GET https://auth.linkhub.co.kr/POPBILL/URL
  • 파트너 포인트를 충전하는 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 800px / height = 700px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/URL?TG=CHRG' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 연동회원 포인트 충전 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=G6IMAVA7FZXLUKPKVFXDJRYU5LSPRSGIWF...Q3RQDO6P6KLW6==="
}

15. GetRefundInfo - 환불 신청 상태 조회

GET https://popbill-test.linkhub.co.kr/Refund/{refundCode}
GET https://popbill.linkhub.co.kr/Refund/{refundCode}
  • 포인트 환불에 대한 상세정보 1건을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
refundCode string 18 Y 환불코드
요청 예시
curl --request GET \
  --url 'https://{domain}/Refund/{refundCode}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
reqDT string 14 신청일시
형식 : yyyyMMddHHmmss
requestPoint string 18 환불 신청포인트
accountBank string 10 환불계좌 은행명
accountNum string 50 환불계좌번호
accountName string 70 환불계좌 예금주명
state number 1 상태
  • 1 접수대기
  • 2 심사중
  • 3 입금대기
  • 4 환불완료
  • 5 취소
reason string 200 환불사유
응답 예시
{
    "reqDT": "20251020103731",
    "requestPoint": "1",
    "accountBank": "국민",
    "accountNum": "123123123-123",
    "accountName": "예금주명",
    "state": 1,
    "reason": "환불사유"
}

16. GetRefundableBalance - 환불 가능 포인트 조회

GET https://popbill-test.linkhub.co.kr/RefundPoint
GET https://popbill.linkhub.co.kr/RefundPoint
  • 환불 가능한 포인트를 확인합니다. (보너스 포인트는 환불 가능 포인트에서 제외됩니다.)
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://{domain}/RefundPoint' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
refundableBalance string - 환불 가능 포인트
응답 예시
{
    "refundableBalance": "11751"
}