계좌 거래내역 확인

1. Search - 수집 내역 확인

금융기관에서 수집된 계좌 거래내역을 확인합니다.

easyFinBankService.search(CorpNum, JobID, TradeType, SearchString, Page, PerPage, Order, UserID, success, error)

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	JobID	string	18	Y	팝빌에서 할당한 작업아이디 → [RequestJob - 수집 요청] API의 반환값
3	TradeType	Array	-	N	거래유형 (다중선택 가능) I 입금 O 출금 ※ 기본값 : 전체조회
4	SearchString	string	-	N	조회 검색어 입·출금액 입금 또는 출금 금액을 입력 거래 내역 메모 [SaveMemo – 거래 내역 메모저장] 을 사용하여 저장한 값 비고 EasyFinBankSearchDetail의 변수 'remark1', 'remark2', 'remark3' ※ 기본값 : 전체조회
5	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
6	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건
7	Order	string	-	N	목록 정렬 방향 D 내림차순 : 기본값 A 오름차순 → API를 호출하고 반환 받은 거래일시(trdt) 기준
8	UserID	string	50	N	팝빌회원 아이디
9	success	function	-	Y	성공에 대한 콜백 함수
10	error	function	-	Y	실패에 대한 콜백 함수

응답

EasyFinBankSearchResult

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지
3	total	number	-	총 검색결과 건수
4	perPage	number	-	페이지 당 목록 건수
5	pageNum	number	-	페이지 번호
6	pageCount	number	-	페이지 개수
7	lastScrapDT	string	14	최종 조회일시 → 형식 : yyyyMMddHHmmss
8	balance	string	20	현재 잔액
9	list	EasyFinBankSearchDetail[]	1,000	거래내역 조회 목록 → 최대 : 1,000건
EasyFinBankSearchDetail[] 순번 변수명 타입 길이 설명 1 tid string 32 거래내역 아이디 → 거래 내역에 대해 팝빌이 할당한 고유 식별값 2 trdate string 8 거래일자 → 형식 : yyyyMMdd 3 trserial number - 거래일련번호 → 거래일자별 거래 내역 순번 4 trdt string 14 거래일시 → 형식 : yyyyMMddHHmmss 5 accIn string 20 입금액 6 accOut string 20 출금액 7 balance string 20 잔액 8 remark1 string 500 비고 1 → {BankCode}="0003"(기업은행) 경우 받는분 계좌번호 {BankCode}="0004"(국민은행) 경우 내통장 표시내용 9 remark2 string 500 비고 2 → 은행별 제공 정보 다름(거래구분, 거래종류, 거래내용, 적요 등) 10 remark3 string 500 비고 3 → 은행별 제공 정보 다름(거래내용, 적요, 내역, 비고 등) 11 remark4 string 500 비고 4 → 은행별 제공 정보 다름(거래점, 취급점, 처리점 등) 12 regDT string 14 등록일시 → 형식 : yyyyMMddHHmmss 13 memo string 100 거래 내역 메모 → [SaveMemo – 거래 내역 메모저장]을 사용하여 저장한 값

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

2. Summary - 수집 내역 합계

금융기관에서 수집된 계좌 거래내역의 입금 및 출금 합계정보를 제공합니다.

easyFinBankService.summary(CorpNum, JobID, TradeType, SearchString, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	JobID	string	18	Y	팝빌에서 할당한 작업아이디 → [RequestJob - 수집 요청] API의 반환값
3	TradeType	Array	-	N	거래유형 (다중선택 가능) I 입금 O 출금 ※ 기본값 : 전체조회
4	SearchString	string	-	N	조회 검색어 입·출금액 입금 또는 출금 금액을 입력 거래 내역 메모 [SaveMemo – 거래 내역 메모저장] 을 사용하여 저장한 값 비고 EasyFinBankSearchDetail의 변수 'remark1', 'remark2', 'remark3' ※ 기본값 : 전체조회
5	UserID	string	50	N	팝빌회원 아이디
6	success	function	-	Y	성공에 대한 콜백 함수
7	error	function	-	Y	실패에 대한 콜백 함수

응답

EasyFinBankSummary

순번	변수명	타입	길이	설명
1	count	number	-	수집 건수
2	cntAccIn	number	-	입금거래 건수
3	cntAccOut	number	-	출금거래 건수
4	totalAccIn	number	-	입금액 합계
5	totalAccOut	number	-	출금액 합계

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

3. SaveMemo - 거래 내역 메모저장

한 건의 거래 내역에 메모를 저장합니다.

easyFinBankService.saveMemo(CorpNum, TID, Memo, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	TID	string	32	Y	메모를 저장할 거래내역 아이디 → [Search - 수집 내역 확인] API를 호출하고 반환 받은 거래내역 아이디(tid)
3	Memo	string	100	Y	거래 내역 메모
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

Response

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

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지