BANK_거래내역조회(법인인증서)

기업뱅킹: 홈 > 로그인 > 거래내역조회

METHOD

POST

URI

/scrap/cfm/bank/TransactionHistoryInquiry

Content Type

application/json

Charset

UTF-8

Last Updated

2022-12-29

Request Fields

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

FCODE

기관코드(입력)

true

STRING

서비스 업무 구분 필드

CUS_KIND

고객구분

STRING

0: 개인, 1: 일반기업, 2: 프리미엄, 4: CMSINET(HANA)

[SC은행, 국민은행, 하나은행] 법인구분시 필요한 필수필드

NUMBER

계좌번호

true

STRING

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

PASSWORD

계좌비밀번호

true

true

STRING

SC은행 계좌에 거래내역조회 시 비밀번호를 설정하였을 경우 필요한 필드.

AUTHACCTNUM

본인인증계좌번호

STRING

우리은행 계좌인증서비스 요구시 필요한 필드

AUTHACCTPWD

본인인증계좌비밀번호

true

STRING

우리은행 계좌인증서비스 요구시 필요한 필드

STARTDATE

조회시작일

true

STRING

yyyyMMdd

예) 20180801

ENDDATE

조회종료일

true

STRING

yyyyMMdd

예) 20180830

COMPRESS_QUERY

압축거래내역체크여부

STRING

0: 비압축거래내역, 1: 압축거래내역

새마을금고에서만 사용되는 입력필드

P_CERTNAME

인증서이름

true

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

true

STRING

BASE64

개별인증서를 위한 CERT 정보

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.NUMBER

계좌번호

STRING

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

data.CURBAL

현재잔액

STRING

data.ACCTNM

예금주명

STRING

data.LIST[]

목록 반복부

입력필드 FILEINFOGUBUN "Y" 일 경우 출력됨.

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[].TRANDES

이체매체

STRING

data.LIST[].TRANDEP

취급점

STRING

data.LIST[].TRANDT

거래시간

STRING

시분초(HHMMSS) 표기

data.LIST[].VRFDT

날짜검증

STRING

P: 정상, W: 확인필요

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

data.LIST[].CONTENT

거래특이사항

STRING

외화거래내역에 사용하는 출력값으로 거래내역에서는 빈값으로 출력

HTTP Request

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

{
  "FCODE" : "MBHNCM",
  "CUS_KIND" : "",
  "NUMBER" : "123412123456",
  "PASSWORD" : "g4H0OJ7w9Fc7h5UtVCNSVQ==\n",
  "STARTDATE" : "20220601",
  "ENDDATE" : "20220801",
  "COMPRESS_QUERY" : "",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}

HTTP Response

HTTP/1.1 200 OK
Date:Thu, 29 Dec 2022 04:34:50 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 870

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "NUMBER" : "123412123456",
    "ERRMSG" : "",
    "CURBAL" : "1000000",
    "ACCTNM" : "홍길동",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "INBAL" : "10000",
      "TRANABAL" : "1000000",
      "TRANDT" : "091127",
      "TRANDEP" : "Hana CBS",
      "TRANDES" : "타행송금",
      "VRFDT" : "P",
      "CONTENT" : "",
      "OUTBAL" : "10000",
      "JUKYO" : "임꺽정",
      "TRANDATE" : "20220602",
      "TRANGB" : "출금"
    }, {
      "INBAL" : "10000",
      "TRANABAL" : "1000000",
      "TRANDT" : "130551",
      "TRANDEP" : "Hana CBS",
      "TRANDES" : "타행송금",
      "VRFDT" : "P",
      "CONTENT" : "",
      "OUTBAL" : "10000",
      "JUKYO" : "임꺽정",
      "TRANDATE" : "20220602",
      "TRANGB" : "출금"
    } ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/cfm/bank/TransactionHistoryInquiry' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "FCODE" : "MBHNCM",
  "CUS_KIND" : "",
  "NUMBER" : "123412123456",
  "PASSWORD" : "g4H0OJ7w9Fc7h5UtVCNSVQ==\n",
  "STARTDATE" : "20220601",
  "ENDDATE" : "20220801",
  "COMPRESS_QUERY" : "",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}'

참고자료

은행코드-법인

은행명 FCODE 은행명 FCODE

국민은행

MBKBCM

수협은행

MBSUCM

신한은행

MBSHCM

경남은행

MBKNCM

농협은행

MBNHCM

신협

MBCUCM

하나은행

MBHNCM

씨티은행

MBCTCM

SC은행

MBSCCM

광주은행

MBKJCM

우리은행

MBWRCM

우체국

MBEPCM

새마을금고

MBKFCM

전북은행

MBJBCM

대구은행

MBDBCM

기업은행

MBIBCM

부산은행

MBPSCM

제주은행

MBJJCM

산업은행

MBKDCM

케이뱅크

MBKKCM

카카오뱅크

MBKOCM