API Reference 문자 PowerBuilder 포인트 관리

4. 포인트 관리

4.1. GetUnitCost - 전송 단가 확인

• 문자 전송시 과금되는 포인트 단가를 확인합니다.

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

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	msgtype	string	-	Y	문자 전송유형 (택 1) SMS단문 LMS장문 MMS포토문자

Return

decimal - 문자 전송단가

Throws

PopbillException

4.2. GetChargeInfo - 과금정보 확인

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

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

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	msgtype	string	-	Y	문자 전송유형 (택 1) SMS단문 LMS장문 MMS포토문자
	userid	string	50	N	팝빌회원 아이디

Return

ChargeInfo

Throws

PopbillException

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

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

function double getbalance(string corpnum) throws popbillexception

Parameters

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

Return

double - 연동회원 잔여포인트

Throws

PopbillException

4.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

4.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

4.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

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

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

function double getpartnerbalance(string corpnum) throws popbillexception

Parameters

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

Return

double - 파트너 잔여포인트

Throws

PopbillException

4.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