1. 계좌 관리

1.1. RegistBankAccount - 계좌 등록

계좌조회 서비스를 이용할 계좌를 팝빌에 등록합니다.

function response registbankaccount(string corpnum, ref easyfinbankaccountform accountinfo, string userid) throws popbillexception

계좌를 등록할 때 결제기간만큼 포인트가 차감됩니다. 단, 파트너 포인트를 이용하는 경우에는 1개월 요금이 과금됩니다.

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
accountinfo	EasyFinBankAccountForm	N	-	등록할 계좌 객체정보
userid	string	50	N	팝빌회원 아이디

Return

Response

Throws

PopbillException

1.2. UpdateBankAccount - 계좌정보 수정

팝빌에 등록된 계좌정보를 수정합니다.

function response updatebankaccount(string corpnum, ref easyfinbankaccountform accountinfo, string userid) throws popbillexception

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
accountinfo	EasyFinBankAccountForm	-	Y	수정할 계좌 객체정보
userid	string	50	N	팝빌회원 아이디

Return

Response

Throws

PopbillException

1.3. GetBankAccountInfo - 계좌정보 확인

팝빌에 등록된 계좌 정보를 확인합니다.

function easyfinbankaccount getbankaccountinfo(string corpnum, string bankcode, string accountnumber, string userid) throws popbillexception

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
bankcode	string	4	Y	은행 기관코드 0011농협 0004국민은행 0020우리은행 0088신한은행 0003기업은행 0081하나은행 0023SC은행 0002산업은행 0027씨티은행 0031대구은행 0032부산은행 0039경남은행 0034광주은행 0037전북은행 0035제주은행 0071우체국 0045새마을금고 0048신협 0007수협
accountnumber	string	30	Y	계좌번호
userid	string	50	N	팝빌회원 아이디

Return

EasyFinBankAccount

Throws

PopbillException

1.4. ListBankAccount - 계좌정보 목록 조회

팝빌에 등록된 계좌정보 목록을 반환합니다.

subroutine listbankaccount (string corpnum, ref easyfinbankaccount ref_returnlist[]) throws popbillexception

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
userid	string	50	N	팝빌회원 아이디
ref_returnlist	ref EasyFinBankAccount[ ]		Y	서브루틴 반환 결과값

Return

Throws

PopbillException

1.5. GetBankAccountMgtURL - 계좌 관리 팝업 URL

계좌 등록, 수정 및 삭제할 수 있는 계좌 관리 팝업 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

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

Parameters

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

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

1.6. closeBankAccount - 정액제 해지요청

팝빌에 등록된 계좌의 정액제 해지를 요청합니다.

function response closebankaccount(string corpnum, string bankcode, string accountnumber, string closetype, string userid) throws popbillexception

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
bankcode	string	4	Y	은행 기관코드 0011농협 0004국민은행 0020우리은행 0088신한은행 0003기업은행 0081하나은행 0023SC은행 0002산업은행 0027씨티은행 0031대구은행 0032부산은행 0039경남은행 0034광주은행 0037전북은행 0035제주은행 0071우체국 0045새마을금고 0048신협 0007수협
accountnumber	string	30	Y	계좌번호
closetype	string	2	Y	정액제 해지 구분 (택 1) 일반해지 요청일이 포함된 정액제 이용기간 만료 후 해지 중도해지 요청 즉시 정지되고 팝빌 담당자가 승인시 해지 "중도"인 경우, 정액제 잔여기간은 일할로 계산되어 포인트 환불(무료 이용기간에 해지하면 전액 환불)
userid	string	50	N	팝빌회원 아이디

Return

Response

Throws

PopbillException

1.7. RevokeCloseBankAccount - 정액제 해지요청 취소

신청한 정액제 해지요청을 취소합니다.

function response revokeclosebankaccount(string corpnum, string bankcode, string accountnumber, string userid) throws popbillexception

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
bankcode	string	4	Y	은행 기관코드 0011농협 0004국민은행 0020우리은행 0088신한은행 0003기업은행 0081하나은행 0023SC은행 0002산업은행 0027씨티은행 0031대구은행 0032부산은행 0039경남은행 0034광주은행 0037전북은행 0035제주은행 0071우체국 0045새마을금고 0048신협 0007수협
accountnumber	string	30	Y	계좌번호
userid	string	50	N	팝빌회원 아이디

Return

Response

Throws

PopbillException

1.8. DeleteBankAccount - 계좌 삭제

등록된 계좌를 삭제합니다.

function response deletebankaccount(string corpnum, string bankcode, string accountnumber, string userid) throws popbillexception

정액제가 아닌 종량제 이용 시에만 등록된 계좌를 삭제할 수 있습니다.
정액제 이용시 [CloseBankAccount – 정액제 해지요청] 함수를 사용하여 정액제를 해제할 수 있습니다.

Parameters

변수명	타입	길이	필수	설명
corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
bankcode	string	4	Y	은행 기관코드 0011농협 0004국민은행 0020우리은행 0088신한은행 0003기업은행 0081하나은행 0023SC은행 0002산업은행 0027씨티은행 0031대구은행 0032부산은행 0039경남은행 0034광주은행 0037전북은행 0035제주은행 0071우체국 0045새마을금고 0048신협 0007수협
accountnumber	string	30	Y	계좌번호
userid	string	50	N	팝빌회원 아이디

Return

Response

Throws

PopbillException