포인트 관리
1. GetUnitCost - 조회 단가 확인
GET
https://popbill-test.linkhub.co.kr/BizInfo/UnitCost
GET
https://popbill.linkhub.co.kr/BizInfo/UnitCost
- 기업정보 조회시 과금되는 포인트 단가를 확인합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
요청 예시
curl --request GET \
--url 'https://{domain}/BizInfo/UnitCost' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| unitCost | string | - | 조회 단가 |
응답 예시
{
"unitCost": "100"
}
2. GetChargeInfo - 과금정보 확인
GET
https://popbill-test.linkhub.co.kr/HomeTax/BizInfo/ChargeInfo
GET
https://popbill.linkhub.co.kr/HomeTax/BizInfo/ChargeInfo
- 팝빌 기업정보조회 API 서비스 과금정보를 확인합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
요청 예시
curl --request GET \
--url 'https://{domain}/BizInfo/ChargeInfo' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| unitCost | string | 12 | 조회단가 | |
| chargeMethod | string | 3 |
과금유형
연동
파트너
|
|
| rateSystem | string | 3 |
과금제도
종량제
|
응답 예시
{
"chargeMethod": "연동",
"rateSystem": "종량제",
"unitCost": "100"
}
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 |
결제상태
|
|
| 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 | - | 결제내역 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
응답 예시
{
"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 | - | 사용내역 | |||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||
응답 예시
{
"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 | - | 결제내역 | |||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||
응답 예시
{
"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 |
상태
|
|
| 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"
}
