포인트 관리

1. GetUnitCost - 조회 단가 확인

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/EasyFin/AccountCheck/UnitCost Copied

• 예금주 조회시 과금되는 포인트 단가를 확인합니다.

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	serviceType	string	2	N	서비스 유형 (택 1) 성명 실명

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/AccountCheck/UnitCost?serviceType={serviceType}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	unitCost	string	-	조회 단가

응답 예시

{
    "unitCost": "10"
}

2. GetChargeInfo - 과금정보 확인

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/EasyFin/AccountCheck/ChargeInfo Copied

• 팝빌 예금주조회 API 서비스 과금정보를 확인합니다.

Request

요청 헤더

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

Query 파라티터

순번	변수명	타입	길이	필수	설명
1	serviceType	string	2	N	서비스 유형 (택 1) 성명 실명

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/AccountCheck/ChargeInfo?serviceType={serviceType}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	unitCost	string	12	조회단가
2	chargeMethod	string	3	과금유형 연동 파트너
3	rateSystem	string	3	과금제도 종량제

응답 예시

{
    "chargeMethod": "연동",
    "rateSystem": "종량제",
    "unitCost": "10"
}

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

테스트(Sandbox) 운영(Production)

GET https://auth.linkhub.co.kr/POPBILL_TEST/Point Copied

• 연동회원의 잔여포인트를 확인합니다.

Request

요청 헤더

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

요청 예시

curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/Point' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	remainPoint	string	-	연동회원 잔여포인트
2	defUsedPoint	string	-	후불사용 포인트

응답 예시

{
    "remainPoint": "84923",
    "defUsedPoint": "0"
}

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

테스트(Sandbox) 운영(Production)

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

미리보기

연동회원 포인트를 충전하는 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 800px / height = 700px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

Request

요청 헤더

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	url	string	-	연동회원 포인트 충전 팝업 URL

응답 예시

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

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

테스트(Sandbox) 운영(Production)

POST https://popbill-test.linkhub.co.kr/Payment Copied

• 연동회원 포인트 충전을 위해 무통장입금을 신청합니다.

Request

요청 헤더

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

요청 본문

순번	변수명	타입	길이	필수	설명
1	settlerName	string	100	N	담당자명
2	settlerEmail	string	100	N	담당자 메일
3	notifyHP	string	20	N	담당자 휴대폰 → 무통장 입금 승인 알림톡이 전송될 번호
4	paymentName	string	70	Y	입금자명
5	settleCost	string	18	Y	결제금액

요청 예시

curl --request POST \
  --url 'https://{domain}/Payment' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "settlerName": "담당자명",
    "settlerEmail": "test@test.com",
    "notifyHP": "01012345678",
    "paymentName": "입금자명",
    "settleCost": "110000"
  }'

Response

응답 본문

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

응답 예시

{
    "code": 1,
    "message": "접수완료",
    "settleCode": "202608140000000001"
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/Payment/{settleCode} Copied

• 연동회원 포인트 무통장 입금신청내역 1건을 확인합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
1	settleCode	string	18	Y	정산코드 → 팝빌에서 임의 할당하는 값으로 [PaymentRequest - 연동회원 무통장 입금신청] 호출시 반환되는 값

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	productType	string	3	결제 내용 포인트 정액제 미수금
2	productName	string	30	결제 상품명
3	settleType	string	7	결제유형 무통장 신용카드 실시간계좌이체
4	settlerName	string	100	담당자명
5	settlerEmail	string	100	담당자 메일
6	settleCost	string	18	결제금액
7	settlePoint	string	18	충전포인트
8	settleState	number	1	결제상태 1 대기 2 승인 3 실패 4 취소 5 취소
9	regDT	string	14	등록일시 → 형식 : yyyyMMddHHmmss
10	stateDT	string	14	상태일시 → 형식 : yyyyMMddHHmmss

응답 예시

{
    "productType": "포인트",
    "productName": "팝빌 포인트 충전",
    "settleType": "무통장",
    "settlerName": "담당자명",
    "settlerEmail": "test@test.com",
    "settleCost": "11000",
    "settlePoint": "10000",
    "settleState": 1,
    "regDT": "20251020092932",
    "stateDT": "20251020092932"
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/PaymentHistory Copied

• 연동회원의 포인트 결제내역을 확인합니다.

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	SDate	string	8	Y	검색 시작일자 → 형식 : yyyyMMdd
2	EDate	string	8	Y	검색 종료일자 → 형식 : yyyyMMdd
3	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
4	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건

요청 예시

curl --request GET \
  --url 'https://{domain}/PaymentHistory?SDate={SDate}&EDate={EDate}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	total	number	-	총 검색결과 건수
3	perPage	number	-	페이지당 목록 건수
4	pageNum	number	-	페이지 번호
5	pageCount	number	-	페이지 개수
6	list	array	-	결제내역
list 순번 변수명 타입 길이 설명 1 productType string 3 결제 내용 포인트 정액제 미수금 2 productName string 30 결제 상품명 3 settleType string 7 결제유형 무통장 신용카드 실시간계좌이체 4 settlerName string 100 담당자명 5 settlerEmail string 100 담당자 메일 6 settleCost string 18 결제금액 7 settlePoint string 18 충전포인트 8 settleState number 1 결제상태 1 대기 2 승인 3 실패 4 취소 5 취소 9 regDT string 14 등록일시 → 형식 : yyyyMMddHHmmss 10 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

테스트(Sandbox) 운영(Production)

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

미리보기

연동회원 포인트 결제내역 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

Request

요청 헤더

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	url	string	-	연동회원 포인트 결제내역 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/API?T=HUC5ZZQK4XZMN7KQFPJC7NMPHGKABA...47XLSGM2S7U6UORIQ="
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/UseHistory Copied

• 연동회원의 포인트 사용내역을 확인합니다.

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	SDate	string	8	Y	검색 시작일자 → 형식 : yyyyMMdd
2	EDate	string	8	Y	검색 종료일자 → 형식 : yyyyMMdd
3	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
4	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건
5	Order	string	1	N	거래일자를 기준으로 하는 목록 정렬 방향 D 내림차순 : 기본값 A 오름차순

요청 예시

curl --request GET \
  --url 'https://{domain}/UseHistory?SDate={SDate}&EDate={EDate}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	total	number	-	총 검색결과 건수
3	perPage	number	-	페이지당 목록 건수
4	pageNum	number	-	페이지 번호
5	pageCount	number	-	페이지 개수
6	list	array	-	사용내역
list 순번 변수명 타입 길이 설명 1 itemCode number 3 서비스 코드 110 세금계산서 111 홈택스수집(세금) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증 140 현금영수증 141 홈택스수집(현금) 150 문자(SMS) 151 문자(LMS) 152 문자(MMS) 153 알림톡 156 브랜드 메시지(I) 157 브랜드 메시지(N) 158 브랜드 메시지(M) 160 팩스(일반망) 161 팩스(지능망) 170 사업자등록상태조회 171 기업정보조회 180 계좌조회 182 성명조회 183 실명조회 2 txType number 2 포인트 증감 유형 11 (포인트 증가) 포인트 충전 12 (포인트 증가) 조정 13 (포인트 증가) 조정 19 (포인트 증가) 분배 31 (포인트 증가) 환불 32 (포인트 증가) 정액제 해지 21 (포인트 감소) 서비스 사용 22 (포인트 감소) 조정 23 (포인트 감소) 조정 24 (포인트 감소) 포인트 결제 25 (포인트 감소) 미수금 결제 26 (포인트 감소) 포인트 환불 29 (포인트 감소) 회수 41 (포인트 감소) 후불누적조정 3 txPoint string 18 증감 포인트 4 balance string 18 잔여 포인트 5 txDT string 14 포인트 증감 일시 → 형식 : yyyyMMddHHmmss 6 userID string 50 담당자 아이디 7 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

테스트(Sandbox) 운영(Production)

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

미리보기

연동회원 포인트 사용내역 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

Request

요청 헤더

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	url	string	-	연동회원 포인트 사용내역 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/API?T=HUC5ZZQK4XZMN7KQFPJC7NMPHGKABA...47XLSGM2S7U6UORIQ="
}

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

테스트(Sandbox) 운영(Production)

POST https://popbill-test.linkhub.co.kr/Refund Copied

• 연동회원 포인트를 환불 신청합니다.

Request

요청 헤더

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

요청 본문

순번	변수명	타입	길이	필수	설명
1	contactname	string	100	Y	담당자명
2	tel	string	20	Y	담당자 연락처
3	requestpoint	string	18	Y	환불 신청 포인트
4	accountbank	string	10	Y	은행명
5	accountnum	string	50	Y	계좌번호
6	accountname	string	70	Y	예금주명
7	reason	string	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

응답 본문

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

응답 예시

{
    "code": 1,
    "message": "환불 신청완료",
    "refundCode": "025100000001"
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/RefundHistory Copied

• 연동회원의 포인트 환불신청내역을 확인합니다.

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
2	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	total	number	-	총 검색결과 건수
3	perPage	number	-	페이지당 목록 건수
4	pageNum	number	-	페이지 번호
5	pageCount	number	-	페이지 개수
6	list	array	-	결제내역
list 순번 변수명 타입 길이 설명 1 reqDT string 14 신청일시 → 형식 : yyyyMMddHHmmss 2 requestPoint string 18 환불 신청포인트 3 accountBank string 10 환불계좌 은행명 4 accountNum string 50 환불계좌번호 5 accountName string 70 환불계좌 예금주명 6 state number 1 상태 1 접수대기 2 심사중 3 입금대기 4 환불완료 5 취소 7 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 - 파트너 잔여포인트 확인

테스트(Sandbox) 운영(Production)

GET https://auth.linkhub.co.kr/POPBILL_TEST/PartnerPoint Copied

• 파트너의 잔여포인트를 확인합니다.

Request

요청 헤더

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

요청 예시

curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/PartnerPoint' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	remainPoint	string	-	파트너 잔여포인트
2	defUsedPoint	string	-	후불사용 포인트

응답 예시

{
    "remainPoint": "32382",
    "defUsedPoint": "0"
}

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

테스트(Sandbox) 운영(Production)

GET https://auth.linkhub.co.kr/POPBILL_TEST/URL Copied

미리보기

파트너 포인트를 충전하는 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 800px / height = 700px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

Request

요청 헤더

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

요청 예시

curl --request GET \
  --url 'https://auth.linkhub.co.kr/{serviceID}/URL?TG=CHRG' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
1	url	string	-	연동회원 포인트 충전 팝업 URL

응답 예시

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

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/Refund/{refundCode} Copied

• 포인트 환불에 대한 상세정보 1건을 확인합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
1	refundCode	string	18	Y	환불코드

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	reqDT	string	14	신청일시 → 형식 : yyyyMMddHHmmss
2	requestPoint	string	18	환불 신청포인트
3	accountBank	string	10	환불계좌 은행명
4	accountNum	string	50	환불계좌번호
5	accountName	string	70	환불계좌 예금주명
6	state	number	1	상태 1 접수대기 2 심사중 3 입금대기 4 환불완료 5 취소
7	reason	string	200	환불사유

응답 예시

{
    "reqDT": "20251020103731",
    "requestPoint": "1",
    "accountBank": "국민",
    "accountNum": "123123123-123",
    "accountName": "예금주명",
    "state": 1,
    "reason": "환불사유"
}

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

테스트(Sandbox) 운영(Production)

GET https://popbill-test.linkhub.co.kr/RefundPoint Copied

• 환불 가능한 포인트를 확인합니다. (보너스 포인트는 환불 가능 포인트에서 제외됩니다.)

Request

요청 헤더

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	refundableBalance	string	-	환불 가능 포인트

응답 예시

{
    "refundableBalance": "11751"
}