거래내역조회

기본정보

기능 : 해당계좌의 거래내역을 조회합니다.
방식 : HTTPS-POST
호출정보 : InquireTransactionHistory.nh
호출결과 : JSON

NH API 입·출력 Layout

요청

거래내역조회 NH API 입 출력 Layout 요청
Element	한글명	Type	Length	optional	Description
Header		공통부
Bncd	은행코드	필드	3	필수	농협은행:011, 상호금융:012
Acno	계좌번호	필드	20	필수
Insymd	조회시작일자	필드	8	필수	최고 1년
Ineymd	조회종료일자	필드	8	필수	조회기간: 최대 3개월
TrnsDsnc	거래구분	필드	1	-	A:전체 M:입금 D:출금, default : A
Lnsq	정렬순서	필드	10	-	ASC:오름차순, DESC:내림차순, default:ASC
PageNo	페이지번호	필드	4	-	default : 1 조회건수 100건 초과하는 경우 (페이지번호 + 1)하여 연속거래 수행
Dmcnt	요청건수	필드	10	필수	최대 요청건수 100건 - 페이지당 건수

응답

거래내역조회 NH API 입 출력 Layout 응답
Element	한글명	Type	Length	optional	Description
Header		공통부
CtntDataYn	연속데이터여부	필드	1	필수	Y:이후데이터있음
TotCnt	총건수	필드	10	필수	미사용
Iqtcnt	조회총건수	필드	10	필수
REC	거래내역목록	반복부		필수	최대 100건
Trdd	거래일자	필드	8	필수
Txtm	거래시각	필드	6	필수
MnrcDrotDsnc	입금출금구분	필드	1	필수	1:신규(입금) 2:입금 3:출금 4:해지(출금)
Tram	거래금액	필드	15	필수
AftrBlnc	거래후잔액	필드	15	필수
TrnsAfAcntBlncSmblCd	거래후계좌잔액 부호코드	필드	1	필수
Smr	적요	필드	50	필수
HnisCd	최급기관코드	필드	3	필수
HnbrCd	취급지점코드	필드	7	필수
Ccyn	취소여부	필드	1	필수	정상:0, 취소:1
Tuno	거래고유번호	필드	50	필수
BnprCntn	통장인자내용	필드	20	필수

NH API 응답코드 및 업무처리 절차

농협입금이체 NH API 응답코드 및 업무처리 절차"
응답코드	응답 메세지	업무처리 절차
AI001	금융정보제공 제3자동의를 하지 않았습니다. 제3자 동의 후 거래해 주세요	- NH 오픈플랫폼 전자서명 가이드 참조하여 전자서명 요청 - PC : URL로 NH오픈플랫폼 전자서명 처리 - 폰(안드로이드, 애플) : NH오픈플랫폼전자서명 APP 호출
AI002	금융정보제공 제3자동의 유효기간이 경과 하였습니다. 제3자 동의 후 거래해 주세요.	- NH 오픈플랫폼 전자서명 가이드 참조하여 전자서명 요청 - PC : URL로 NH오픈플랫폼 전자서명 처리 - 폰(안드로이드, 애플) : NH오픈플랫폼전자서명 APP 호출

Request example

{
"Header":{
    "ApiNm":"InquireTransactionHistory",
    "Tsymd":"20191129",
    "Trtm":"003544",
    "Iscd":"000019",
    "FintechApsno":"001",
    "ApiSvcCd":"ReceivedTransferA",
    "IsTuno":"201911290000000001",
    "AccessToken":
    "791c18f7377be31c8b30b27eba8573de0aac529890c7b18ac722f6120adc5054"},
    "Bncd":"011",
    "Acno":"3020000000109",
    "Insymd":"20191101",
    "Ineymd":"20191124",
    "TrnsDsnc":"A",
    "Lnsq":"ASC",
    "PageNo":"1",
    "Dmcnt":"5"
}

Response example

{
    "Header": {
        "Trtm": "003544",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "InquireTransactionHistory",
        "IsTuno": "201911290000000001",
        "Tsymd": "20191129",
        "FintechApsno": "001",
        "Iscd": "000019",
        "Rpcd": "00000",
        "ApiSvcCd": "ReceivedTransferA"
    },
    "CtntDataYn": "N",
    "TotCnt": "1",
    "Iqtcnt": "1"
        "REC": [
        {
        	"Trdd": "20191124",
        	"Txtm": "222637",
        	"MnrcDrotDsnc": "3",
        	"Tram": "1004",
            "AftrBlnc": "1100097648",
            "TrnsAfAcntBlncSmblCd": "+",
            "Smr": null,
            "HnisCd": "000",
            "HnbrCd": "0000000",
            "Ccyn": "0",
            "Tuno": "700",
            "BnprCntn": "테스트"
        }
		]
}