POPBill Developers
API Reference

4. 정액제 신청 / 포인트 관리

4.1. GetFlatRateState - 정액제 서비스 상태 확인

  • 홈택스연동 정액제 서비스 상태를 확인합니다.
HTFlatRate GetFlatRateState(string CorpNum, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

HTFlatRate

Throws

PopbillException

4.2. GetFlatRatePopUpURL - 정액제 서비스 신청 팝업 URL

  • 홈택스연동 정액제 서비스 신청 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
string GetFlatRatePopUpURL(string CorpNum, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

string - 요청에 대한 응답 URL

Throws

PopbillException

4.3. GetChargeInfo - 과금정보 확인

  • 팝빌 홈택스연동 API 서비스 과금정보를 확인합니다.
ChargeInfo GetChargeInfo(string CorpNum, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

ChargeInfo

Throws

PopbillException

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

  • 연동회원의 잔여포인트를 확인합니다.
double GetBalance(string CorpNum)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
Return

double - 연동회원 잔여포인트

Throws

PopbillException

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

  • 연동회원 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
string GetChargeURL(string CorpNum, string UserID)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 Y 팝빌회원 아이디
Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

  • 연동회원의 포인트 사용내역을 확인합니다.
UseHistoryResult GetUseHistory(string CorpNum, string SDate, string EDate, int? Page = null, int? PerPage = null, string Order = null, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
SDate string 8 Y 조회 기간의 시작일자
형식 : yyyyMMdd
EDate string 8 Y 조회 기간의 종료일자
형식 : yyyyMMdd
Page int? - N 목록 페이지번호
기본값 : 1
PerPage int? - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
Order string 1 N 거래일자를 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
UserID string 50 N 팝빌회원 아이디
Return

UseHistoryResult

Throws

PopbillException

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

  • 연동회원 포인트 사용내역 확인을 위한 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
string GetUseHistoryURL(string CorpNum, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

  • 연동회원 포인트 충전을 위해 무통장입금을 신청합니다.
PaymentResponse PaymentRequest(string CorpNum, PaymentForm paymentForm, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
paymentForm PaymentForm - Y 입금신청 객체정보
UserID string 50 N 팝빌회원 아이디
Return

PaymentResponse

Throws

PopbillException

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

  • 연동회원 포인트 무통장 입금신청내역 1건을 확인합니다.
PaymentHistory GetSettleResult(string CorpNum, string settleCode, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
SettleCode string 18 Y 정산코드
팝빌에서 임의 할당하는 값으로 [PaymentRequest - 연동회원 무통장 입금신청] 호출시 반환되는 값
UserID string 50 N 팝빌회원 아이디
Return

PaymentHistory

Throws

PopbillException

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

  • 연동회원의 포인트 결제내역을 확인합니다.
PaymentHistoryResult GetPaymentHistory(string CorpNum, string SDate, string EDate, int? Page, int? PerPage, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
SDate string 8 Y 조회 기간의 시작일자
형식 : yyyyMMdd
EDate string 8 Y 조회 기간의 종료일자
형식 : yyyyMMdd
Page int? - N 목록 페이지번호
기본값 : 1
PerPage int? - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
UserID string 50 N 팝빌회원 아이디
Return

PaymentHistoryResult

Throws

PopbillException

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

  • 연동회원 포인트 결제내역 확인을 위한 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
string GetPaymentURL(string CorpNum, string UserID =null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

  • 연동회원 포인트를 환불 신청합니다.
 RefundResponse Refund(string CorpNum, RefundForm refundForm, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
refundForm RefundForm - Y 환불신청 객체정보
UserID string 50 N 팝빌회원 아이디
Return

RefundResponse

Throws

PopbillException

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

  • 연동회원의 포인트 환불신청내역을 확인합니다.
 RefundHistoryResult GetRefundHistory(string CorpNum, int? Page = null, int? PerPage = null, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
Page int? - N 목록 페이지번호
기본값 : 1
PerPage int? - N 페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
UserID string 50 N 팝빌회원 아이디
Return

RefundHistoryResult

Throws

PopbillException

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

  • 포인트 환불에 대한 상세정보 1건을 확인합니다.
RefundHistory GetRefundInfo(string CorpNum, string RefundCode, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
RefundCode string 18 Y 환불코드
UserID string 50 N 팝빌회원 아이디
Return

RefundHistory

Throws

PopbillException

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

  • 환불 가능한 포인트를 확인합니다. (보너스 포인트는 환불가능포인트에서 제외됩니다.)
double GetRefundableBalance(string CorpNum, string UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
Return

double - 환불 가능 포인트

Throws

PopbillException

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

  • 파트너의 잔여포인트를 확인합니다.
double GetPartnerBalance(string CorpNum)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
Return

double - 파트너 잔여포인트

Throws

PopbillException

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

  • 파트너 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
string GetPartnerURL(string CorpNum, string TOGO)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
TOGO string - Y 고정값 : "CHRG"
Return

string - 요청에 대한 응답 URL

Throws

PopbillException