거래내역 확인

1. Search - 수집 내역 확인

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

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

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

Request

요청 헤더

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

Path 파라미터

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	`TradeType`	string	-	N	거래유형 (다중 선택 가능) `I` 입금 `O` 출금 다중 선택시 콤마(',')로 구분. 예) I,O 기본값 : 전체조회
2	`SearchString`	string	-	N	조회 검색어 `입·출금액` 입금 또는 출금 금액을 입력 `거래 내역 메모` [SaveMemo – 거래 내역 메모저장] 을 사용하여 저장한 값 `비고` remark1, remark2, remark3 조회 기본값 : 전체조회
3	`Page`	number	-	N	목록 페이지번호 기본값 : 1
4	`PerPage`	number	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
5	`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

현재 잔액

array

거래내역 조회 목록

최대 : 1,000건

list

순번	변수명	타입	길이	설명
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 – 거래 내역 메모저장]을 사용하여 저장한 값

응답 예시

{
    "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

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

Request

요청 헤더

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

Path 파라미터

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	`TradeType`	string	-	N	거래유형 (다중 선택 가능) `I` 입금 `O` 출금 다중 선택시 콤마(',')로 구분. 예) I,O 기본값 : 전체조회
2	`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

응답 본문

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

응답 예시

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

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

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

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

Request

요청 헤더

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

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

응답 예시

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