Usage accountCheckService

var popbill = require('popbill');

popbill.config({

    // 링크아이디
    LinkID: 'TESTER',

    // 비밀키
    SecretKey: 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=',

    // 연동환경 설정값, 개발용(true), 상업용(false)
    IsTest: true,

    // 인증토큰 IP제한기능 사용여부, 권장(true)
    IPRestrictOnOff: true,

    // 인증토큰정보 로컬서버 시간 사용여부
    UseLocalTimeYN: true,

    defaultPopbillExceptionorHandler: function (Error) {
        console.log('Error Occur : [' + Error.code + '] ' + Error.message);
    }
});

var accountCheckService  = popbill.AccountCheckService();

1. 예금주조회

1.1. CheckAccountInfo - 예금주성명 조회

ㆍ1건의 예금주성명을 조회합니다.

accountCheckService.checkAccountInfo(CorpNum, BankCode, AccountNumber, UserID, success, error)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 BankCode string 4 O 조회할 기관코드
[참고] 조회 가능한 금융기관
3 AccountNumber string 30 O 조회할 기관의 계좌번호 (하이픈 '-' 제외)
4 UserID string 50 - 팝빌회원 아이디
5 success Function - O 성공에 대한 콜백 함수
6 error Function - O 실패에 대한 콜백 함수

Return

AccountInfo

Throws

PopbillException

2. 포인트 관리

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

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

accountCheckService.getBalance(CorpNum, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

string - 연동회원 잔여포인트

Throws

PopbillException

2.2. GetChargeURL - 연동회원 포인트충전 URL

ㆍ 팝빌 연동회원 사업자의 포인트 충전 팝업 URL을 반환합니다.

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

accountCheckService.getChargeURL(CorpNum, UserID, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 callback Function - O 성공에 대한 콜백 함수
4 err Function - O 실패에 대한 콜백 함수

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

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

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

accountCheckService.getPartnerBalance(CorpNum, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

string - 파트너 잔여포인트

Throws

PopbillException

2.4. GetPartnerURL - 파트너 포인트충전 URL

ㆍ 파트너 포인트충전 팝업 URL 을 반환합니다.

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

accountCheckService.getPartnerURL(CorpNum, TOGO, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 TOGO string - O CHRG : 파트너 포인트 충전
3 callback Function - O 성공에 대한 콜백 함수
4 err Function - O 실패에 대한 콜백 함수

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

2.5. GetUnitCost - 조회 단가 확인

ㆍ 예금주 성명 조회 단가를 확인합니다.

accountCheckService.getUnitCost(CorpNum, success, error)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 success Function - O 성공에 대한 콜백 함수
3 error Function - O 실패에 대한 콜백 함수

Return

string - 예금주 성명 조회 단가

Throws

PopbillException

2.6. GetChargeInfo - 과금정보 확인

ㆍ 예금주조회 서비스 과금정보를 확인합니다.

accountCheckService.getChargeInfo(CorpNum, UserID, success, error)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 success Function - O 성공에 대한 콜백 함수
4 error Function - O 실패에 대한 콜백 함수

Return

ChargeInfo

Throws

PopbillException

5. 회원정보

5.1. CheckIsMember - 연동회원 가입여부 확인

ㆍ사업자번호를 조회하여 연동회원 가입여부를 확인합니다.

accountCheckService.checkIsMember(CorpNum, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

5.2. CheckID - 아이디 중복 확인

ㆍ사용하고자 하는 아이디의 중복여부를 확인합니다.

accountCheckService.checkID(targetID, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 targetID string 10 O 중복여부 확인 할 아이디
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

Response - code : 0 (미사용중) / code : 1 (사용중)

Throws

PopbillException

5.3. JoinMember - 연동회원 신규가입

ㆍ사용자를 연동회원으로 가입처리합니다.

accountCheckService.joinMember(JoinForm, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 JoinInfo JoinInfo - O 연동 회원 정보 객체
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

5.4. GetAccessURL - 팝빌 로그인 URL

ㆍ팝빌 사이트에 로그인 상태로 접근할 수 있는 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

accountCheckService.getAccessURL(CorpNum, UserID, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 callback Function - O 성공에 대한 콜백 함수
4 err Function - O 실패에 대한 콜백 함수

Return

string - 요청에 대한 응답 URL

Throws

PopbillException

5.5. GetCorpInfo - 회사정보 확인

ㆍ연동회원의 회사정보를 수정합니다.

accountCheckService.getCorpInfo(CorpNum, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

CorpInfo

Throws

PopbillException

5.6. UpdateCorpInfo - 회사정보 수정

ㆍ연동회원의 회사정보를 수정합니다.

accountCheckService.updateCorpInfo(CorpNum, UserID, CorpInfo, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 CorpInfo CorpInfo - O 회사정보 객체
4 callback Function - O 성공에 대한 콜백 함수
5 err Function - O 실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

5.7. RegistContact - 담당자 등록

ㆍ연동회원 사업자번호에 담당자(팝빌 로그인 계정)를 추가합니다.

accountCheckService.registContact(CorpNum, UserID, ContactInfo, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 JoinInfo ContactInfo - O 담당자 정보 객체
4 callback Function - O 성공에 대한 콜백 함수
5 err Function - O 실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

5.8. ListContact - 담당자 목록 확인

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 목록을 확인합니다.

accountCheckService.listContact(CorpNum, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

ContactInfo

Throws

PopbillException

5.9. UpdateContact - 담당자 정보 수정

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 정보를 수정합니다.

accountCheckService.updateContact(CorpNum, UserID, ContactInfo, callback, err)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID string 50 - 팝빌회원 아이디
3 CorpInfo ContactInfo - O 담당자 정보 객체
2 callback Function - O 성공에 대한 콜백 함수
3 err Function - O 실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

A. 객체정보

A.1. Response

순번 변수명 항목명 타입 길이 비고
1 code 코드 number - API 처리에 대한 응답코드
2 message 메시지 string - API 처리에 대한 응답 메시지

A.2. PopbillException

순번 변수명 항목명 타입 길이 비고
1 code 코드 number - API 처리 실패에 대한 오류코드("-"로 시작하는 8자리 숫자값)
[참고] 오류코드
2 message 메시지 string - API 처리 실패에 대한 오류메시지

A.3. AccountInfo

순번 변수명 항목명 타입 길이 비고
1 resultCode 응답코드 string 10 [1.1. CheckAccountInfo - 예금주성명 조회] 함수 호출에 대한 결과 코드
[참고] 예금주조회 결과 코드 테이블
2 resultMessage 응답메시지 string 2000 [1.1. CheckAccountInfo - 예금주성명 조회] 함수 호출에 대한 결과 메시지
3 accountName 예금주 성명 string 200
4 bankCode 기관코드 string 4
5 accountNumber 계좌번호 string 30
6 checkDate 확인일시 number 13 타임스탬프 (단위 : ms)

A.4. ChargeInfo

순번 변수명 항목명 타입 길이 비고
1 unitCost 조회단가 string -
2 chargeMethod 과금유형 string - "연동" / "파트너" 중 반환
3 rateSystem 과금제도 string - "종량제" 반환

A.5. JoinForm

순번 변수명 항목명 타입 길이 필수 비고
1 id 아이디 string 50 O 6자 이상 50자 미만
2 pwd 비밀번호 string 20 O 8자 이상 20자 이하
3 LinkID 파트너 링크아이디 string 20 O 연동신청시 팝빌에서 발급받은 링크아이디
4 CorpNum 사업자번호 string 10 O 하이픈 '-' 제외 10자리 숫자값
5 ceoname 대표자 성명 string 100 O
6 corpName 상호 string 200 O
7 addr 사업장 주소 string 300 O
8 bizType 업태 string 100 O
9 bizClass 종목 string 100 O
10 ContactName 담당자 성명 string 100 O
11 ContactEmail 담당자 이메일 string 100 O
12 ContactTEL 담당자 연락처 string 20 O
13 ContactHP 담당자 휴대폰번호 string 20 -
14 ContactFAX 담당자 팩스번호 string 20 -

A.6. CorpInfo

순번 변수명 항목명 타입 길이 필수 비고
1 ceoname 대표자 성명 string 100 O
2 corpName 상호 string 200 O
3 addr 주소 string 300 O
4 bizType 업태 string 100 O
5 bizClass 종목 string 100 O

A.7. ContactInfo

순번 변수명 항목명 타입 길이 필수 비고
1 id 아이디 string 50 O 6자 이상 50자 미만
2 pwd 비밀번호 string 20 담당자 추가시 필수, 8자 이상 20자 이하
3 personName 담당자 성명 string 100 O
4 tel 담당자 연락처 string 20 O
5 hp 담당자 휴대폰번호 string 20 -
6 fax 담당자 팩스번호 string 20 -
7 email 담당자 이메일 string 100 O
8 regDT 등록일시 string 14 X
9 searchAllAllowYN 담당자 조회권한 설정 boolean - - true : (회사권한 - 연동회원의 모든 계좌 관리가능) / false : (개인권한 - 담당자 계정이 등록한 계좌 관리가능) 중 반환
※ 미입력시 기본값 false 처리
10 mgrYN 관리자 여부 boolean - X true : (관리자) / false : (비관리자) 중 반환
※ 팝빌 사이트 [마이페이지] > [회사정보] > [담당자 관리]에서 수정 가능
11 state 상태 number 1 X 0 : (승인대기 - 관리자의 승인 후 이용가능) / 1 : (사용중) 중 반환