계좌 거래내역 확인

1. Search - 수집 내역 확인

GET https://popbill-test.linkhub.co.kr/EasyFin/Bank/{jobID}

GET https://popbill.linkhub.co.kr/EasyFin/Bank/{jobID}

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

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	jobID	string	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값

Query 파라미터

변수명	타입	길이	필수	설명
TradeType	string	-	N	거래유형 (다중 선택 가능) I입금 O출금 다중 선택시 콤마(',')로 구분. 예) I,O 기본값 : 전체조회
SearchString	string	-	N	조회 검색어 입·출금액입금 또는 출금 금액을 입력 거래 내역 메모[SaveMemo – 거래 내역 메모저장]을 사용하여 저장한 값 비고remark1, remark2, remark3 조회 기본값 : 전체조회
Page	number	-	N	목록 페이지번호 기본값 : 1
PerPage	number	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	string	1	N	목록 정렬 방향 D내림차순 : 기본값 A오름차순 API를 호출하고 반환 받은 거래일시(trdt) 기준

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/Bank/{jobID}?TradeType={TradeType}&SearchString={SearchString}&Page={Page}&PerPage={PerPage}&Order={Order}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번

변수명

타입

길이

설명

code

number

API 처리에 대한 응답코드

1성공

message

string

API 처리에 대한 응답메시지

total

number

총 검색결과 건수

perPage

number

페이지당 목록 건수

pageNum

number

페이지 번호

pageCount

number

페이지 개수

lastScrapDT

string

최종 조회일시

형식 : yyyyMMddHHmmss

balance

string

현재 잔액

list

array

거래내역 조회 목록

최대 : 1,000건

변수명	타입	길이	설명
tid	string	32	거래내역 아이디 거래 내역에 대한 팝빌이 할당한 고유 식별값
trdate	string	8	거래일자 형식 : yyyyMMdd
trserial	number	-	거래일련번호 거래일자별 거래 내역 순번
trdt	string	14	거래일시 형식 : yyyyMMddHHmmss
accIn	string	20	입금액
accOut	string	20	출금액
balance	string	20	잔액
remark1	string	500	비고 1 - {BankCode}="0003"(기업은행) 경우 받는분 계좌번호 - {BankCode}="0004"(국민은행) 경우 내통장 표시내용
remark2	string	500	비고 2 은행별 제공 정보 다름(거래구분, 거래종류, 거래내용, 적요 등)
remark3	string	500	비고 3 은행별 제공 정보 다름(거래내용, 적요, 내역, 비고 등)
remark4	string	500	비고 4 은행별 제공 정보 다름(거래점, 취급점, 처리점 등)
regDT	string	14	등록일시 형식 : yyyyMMddHHmmss
memo	string	100	거래 내역 메모 [SaveMemo – 거래 내역 메모저장]을 사용하여 저장한 값

응답 예시

{
    "code": 1,
    "total": 0,
    "perPage": 500,
    "pageNum": 1,
    "pageCount": 0,
    "list": [
              {
                "memo": "",
                "tid": "02301311400000000120250930000001",
                "trdate": "20250930",
                "trserial": 1,
                "trdt": "20250930144901",
                "accIn": "1000",
                "accOut": "0",
                "remark4": "",
                "balance": "8000",
                "regDT": "20251022194257",
                "remark1": "(주)링크허브",
                "remark2": "",
                "remark3": "전자망"
              }
    ],
    "message": "확인완료",
    "lastScrapDT": "20251021111915",
    "balance": "2000"
}

2. Summary - 수집 내역 합계

GET https://popbill-test.linkhub.co.kr/EasyFin/Bank/{jobID}/Summary

GET https://popbill.linkhub.co.kr/EasyFin/Bank/{jobID}/Summary

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	jobID	string	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값

Query 파라미터

순번	변수명	타입	길이	필수	설명
	TradeType	string	-	N	거래유형 (다중 선택 가능) I입금 O출금 다중 선택시 콤마(',')로 구분. 예) I,O 기본값 : 전체조회
	SearchString	string	-	N	조회 검색어 입·출금액입금 또는 출금 금액을 입력 거래 내역 메모[SaveMemo – 거래 내역 메모저장]을 사용하여 저장한 값 비고remark1, remark2, remark3 내용 조회 기본값 : 전체조회

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/Bank/{jobID}/Summary?TradeType={TradeType}&SearchString={SearchString}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
count	number	-	수집 건수
cntAccIn	number	-	입금거래 건수
cntAccOut	number	-	출금거래 건수
totalAccIn	number	-	입금액 합계
totalAccOut	number	-	출금액 합계

응답 예시

{
    "count": 0,
    "cntAccIn": 0,
    "cntAccOut": 0,
    "totalAccIn": 0,
    "totalAccOut": 0
}

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

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/SaveMemo

POST https://popbill.linkhub.co.kr/EasyFin/Bank/SaveMemo

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	TID	number	32	Y	메모를 저장할 거래내역 아이디 [Search - 수집 내역 확인] API를 호출하고 반환 받은 거래내역 아이디(tid)
	Memo	number	100	Y	거래 내역 메모

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/SaveMemo?TID={TID}&Memo={Memo}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

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

응답 예시

{
    "code": 1,
    "message": "저장 완료"
}