POPBill Developers
API Reference

1. 계좌 관리

1.1. RegistBankAccount - 계좌 등록

  • 계좌조회 서비스를 이용할 계좌를 팝빌에 등록합니다.
function RegistBankAccount(CorpNum : String; BankInfo : TEasyFinBankAccountForm; UsePeriod : String; UserID : String = '') : TResponse;
  • 계좌를 등록할 때 결제기간만큼 포인트가 차감됩니다. 단, 파트너 포인트를 이용하는 경우에는 1개월 요금이 과금됩니다.
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
BankInfo TEasyFinBankAccountForm - Y 등록할 계좌 객체정보
UsePeriod String 2 N 이용할 결제기간
  • 11개월
  • 22개월
  • 33개월
  • 44개월
  • 55개월
  • 66개월
  • 77개월
  • 88개월
  • 99개월
  • 1010개월
  • 1111개월
  • 1212개월
파트너 포인트 사용시 입력값에 관계 없이 기본값 적용
기본값 : 1개월
UserID String 50 N 팝빌회원 아이디
Return

TResponse

Throws

EPopbillException

1.2. UpdateBankAccount - 계좌정보 수정

  • 팝빌에 등록된 계좌정보를 수정합니다.
function UpdateBankAccount(CorpNum : String; BankInfo : TEasyFinBankAccountForm; UserID : String = '') : TResponse;
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
BankInfo TEasyFinBankAccountForm 4 Y 수정할 계좌 객체정보
UserID String 50 N 팝빌회원 아이디
Return

TResponse

Throws

EPopbillException

1.3. GetBankAccountInfo - 계좌정보 확인

  • 팝빌에 등록된 계좌 정보를 확인합니다.
function GetBankAccountInfo(CorpNum : String; BankCode : String; AccountNumber : String; UserID : String = '') : TEasyFinBankAccountInfo;
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

TEasyFinBankAccountInfo

Throws

EPopbillException

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

  • 팝빌에 등록된 계좌정보 목록을 반환합니다.
function ListBankAccount (CorpNum : String; UserID : String = '') : TEasyFinBankAccountInfoList;
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
Return

Array of TEasyFinBankAccountInfo

Throws

EPopbillException

1.5. GetBankAccountMgtURL - 계좌 관리 팝업 URL

  • 계좌 등록, 수정 및 삭제할 수 있는 계좌 관리 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetBankAccountMgtURL(CorpNum : String; UserID : String = '') : String;
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

1.6. CloseBankAccountInfo - 정액제 해지요청

  • 팝빌에 등록된 계좌의 정액제 해지를 요청합니다.
function CloseBankAccountInfo(CorpNum : String; BankCode : String; AccountNumber : String; CloseType : String; UserID : String = '') : TResponse;
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

TResponse

Throws

EPopbillException

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

  • 신청한 정액제 해지요청을 취소합니다.
function RevokeCloseBankAccountInfo(CorpNum : String; BankCode : String; AccountNumber : String; UserID : String = '') : TResponse;
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

TResponse

Throws

EPopbillException

1.8. DeleteBankAccount - 계좌 삭제

  • 등록된 계좌를 삭제합니다.
function DeleteBankAccount(CorpNum : String; BankCode : String; AccountNumber : String; UserID : String = '') : TResponse;
  • 정액제가 아닌 종량제 이용 시에만 등록된 계좌를 삭제할 수 있습니다.
  • 정액제 이용시 [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

TResponse

Throws

EPopbillException