API Reference 전자명세서 PowerBuilder 포인트 관리

5. 포인트 관리

5.1. GetUnitCost - 발행 단가 확인

• 전자명세서 발행시 과금되는 포인트 단가를 확인합니다.

function decimal getunitcost(string corpnum, string itemcodestr) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	itemcodestr	string	3	Y	확인할 전자명세서의 유형 코드 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증

Return

decimal - 전자명세서 발행단가

Throws

PopbillException

5.2. GetChargeInfo - 과금정보 확인

• 팝빌 전자명세서 API 서비스 과금정보를 확인합니다.

function chargeinfo getchargeinfo(string corpnum, string itemcode, string userid) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	itemcodestr	string	3	Y	확인할 전자명세서의 유형 코드 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증
	userid	string	50	N	팝빌회원 아이디

Return

ChargeInfo

Throws

PopbillException

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

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

function double getbalance(string corpnum) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)

Return

double - 연동회원 잔여포인트

Throws

PopbillException

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

• 연동회원 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
• 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function string getChargeURL(string corpnum, string userid) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	userid	string	50	N	팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

• 연동회원 포인트 결제내역 확인을 위한 페이지의 팝업 URL을 반환합니다.
• 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function string getpaymenturl (string corpnum, string userid) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	userid	string	50	N	팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

• 연동회원 포인트 사용내역 확인을 위한 페이지의 팝업 URL을 반환합니다.
• 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function string getusehistoryurl (string corpnum, string userid) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	userid	string	50	N	팝빌회원 아이디

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

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

function double getpartnerbalance(string corpnum) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)

Return

double - 파트너 잔여포인트

Throws

PopbillException

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

• 파트너 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.
• 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function string getpartnerurl(string corpnum, string togo) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	togo	string	4	Y	고정값 : "CHRG"

Return

string - 요청에 대한 응답 URL

Throws

PopbillException