BANK_거래내역간편조회

은행서비스 거래내역간편조회 업무

METHOD

POST

URI

/scrap/fm/bank/bankstatementEasyInquiry

Content Type

application/json

Charset

UTF-8

Last Updated

2023-07-04

Request Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

FCODE

기관코드(입력)

true

STRING

서비스 업무 구분 필드

NUMBER

계좌번호

STRING

(공통) "-"없이 입력.

PASSWORD

계좌(카드)비밀번호

true

STRING

[증권사] 이베스트, 교보, 동부, 키움 증권사는 상세조회시 계좌비밀번호 필요.

REGNUMBER

사업자번호 또는 주민번호

true

STRING

"-" 구분 없이 숫자만 입력

STARTDATE

조회시작일

true

STRING

yyyyMMdd

예) 20180801

ENDDATE

조회종료일

true

STRING

yyyyMMdd

예) 20180830

CURRCD

통화코드

STRING

(은행서비스) 외화계좌일 경우 통화코드 필수입력

LOGINID

로그인아이디

STRING

-

LOGINPWD

로그인비밀번호

true

STRING

RESULTMOD

결과값 가공여부

STRING

S: SUCCESS, F: FAIL

거래내역이 없을 경우 RESULTMOD 값이 S일 경우 SUCCESS로 F일 경우에는 FAIL로 가공함.

Response Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

errCode

errCode

STRING

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

RESULT값이 FAIL일 경우 스크래핑 서비스 오류 메세지 출력

data.ERRDOC

에러 문서 메시지

STRING

-

data.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.ACCTKIND

계좌종류

STRING

data.NUMBER

계좌번호

STRING

(공통) "-"없이 입력.

data.CURBAL

현재잔액

STRING

data.ENBBAL

출금가능잔액

STRING

data.ACCTNM

예금주명

STRING

data.OPENDATE

개시일

STRING

yyyyMMdd

(은행서비스) 신규일

data.LIST[]

목록 반복부

-

data.LIST[].TRANDATE

거래기간

STRING

yyyymmdd

(은행서비스) 거래일자

data.LIST[].TRANGB

거래종류

STRING

입금 / 출금

data.LIST[].OUTBAL

출금금액

STRING

data.LIST[].INBAL

입금금액

STRING

data.LIST[].TRANABAL

거래후잔액

STRING

data.LIST[].JUKYO

의뢰인명

STRING

국민은행 조회시 의뢰인/수취인 조회

data.LIST[].MEMO

메모

STRING

국민은행 조회시 내통장표시내용 조회

data.LIST[].TRANDES

이체매체

STRING

data.LIST[].TRANDEP

취급점

STRING

data.LIST[].TRANDT

거래시간

STRING

시분초(HHMMSS) 표기

data.LIST[].VRFDT

날짜검증

STRING

P: 정상, W: 확인필요

입력된 조회기간내에 포함되지 않은 거래건이 있는지 검증하는 출력필드

HTTP Request

POST /scrap/fm/bank/bankstatementEasyInquiry
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 290
Content-Type: application/json;charset=UTF-8

{
  "FCODE" : "MBKBFM",
  "NUMBER" : "123412123456",
  "PASSWORD" : "***************",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "STARTDATE" : "20230530",
  "ENDDATE" : "20230610",
  "CURRCD" : "KRW",
  "LOGINID" : "eaccounting01",
  "LOGINPWD" : "/UsnjwptSIXmmuwoe==",
  "RESULTMOD" : "S"
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 4 Jul 2023 02:20:57 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 946

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "OPENDATE" : "",
    "ETRACK" : "",
    "ACCTKIND" : "사업자응원통장",
    "NUMBER" : "123412123456",
    "ERRMSG" : "",
    "CURBAL" : "1000000",
    "ACCTNM" : "홍길동",
    "ECODE" : "",
    "ERRDOC" : "",
    "ENBBAL" : "100000",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "INBAL" : "10000",
      "TRANABAL" : "1000000",
      "TRANDT" : "090615",
      "TRANDEP" : "경남은행",
      "TRANDES" : "전자금융",
      "VRFDT" : "P",
      "OUTBAL" : "10000",
      "JUKYO" : "임꺽정",
      "TRANDATE" : "20230530",
      "MEMO" : "수취2n(명)",
      "TRANGB" : "입금"
    }, {
      "INBAL" : "10000",
      "TRANABAL" : "1000000",
      "TRANDT" : "090704",
      "TRANDEP" : "가산I",
      "TRANDES" : "인터넷출금이체",
      "VRFDT" : "P",
      "OUTBAL" : "10000",
      "JUKYO" : "임꺽정",
      "TRANDATE" : "20230530",
      "MEMO" : "수취2n(명)",
      "TRANGB" : "출금"
    } ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/fm/bank/bankstatementEasyInquiry' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "FCODE" : "MBKBFM",
  "NUMBER" : "123412123456",
  "PASSWORD" : "***************",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "STARTDATE" : "20230530",
  "ENDDATE" : "20230610",
  "CURRCD" : "KRW",
  "LOGINID" : "eaccounting01",
  "LOGINPWD" : "/UsnjwptSIXmmuwoe==",
  "RESULTMOD" : "S"
}'

참고자료

은행코드-빠른조회

은행명 FCODE 은행명 FCODE

국민은행

MBKBFM

수협은행

MBSUFM

신한은행

MBSHFM

경남은행

MBKNFM

농협은행

MBNHFM

신협

MBCUFM

하나은행

MBHNFM

씨티은행

MBCTFM

SC은행

MBSCFM

광주은행

MBKJFM

우리은행

MBWRFM

우체국

MBEPFM

새마을금고

MBKFFM

전북은행

MBJBFM

대구은행

MBDBFM

기업은행

MBIBFM

부산은행

MBPSFM

제주은행

MBJJFM

산업은행

MBKDFM

K뱅크

MBKKFM