가상계좌 입금내역 조회

기본정보

  • 기능 : 가상계좌의 입금내역을 조회한다.
  • 방식 : HTTPS-POST
  • 호출정보 : VirtualAccountReceivedListInquiry.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

가상계좌 입금내역 조회 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
Insymd 조회시작일자 필드 8 필수 - 거래일자 기준/현재일자 이후 조회불가
- 유효 타입: yyyyMMdd
Ineymd 조회종료일자 필드 8 필수 - 거래일자 기준/현재일자 이후 조회불가
- 유효 타입: yyyyMMdd
- 조회범위 1일 이내
Vran 가상계좌번호 필드 20 선택 가상계좌 입력 시 해당 가상계좌의 내역 조회
Lnsq 정렬순서 필드 10 선택 ASC:오름차순, DESC:내림차순, default:DESC
PageNo 페이지번호 필드 4 선택 Default : 1

응답

가상계좌 입금내역 조회 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
TotCnt 총건수 필드 10 필수  
IqtCnt 조회총건수 필드 10 필수  
PageNo 페이지번호 필드 4 필수  
REC 입금내역목록 반복부   필수 페이지당 20 건
Sqno 일련번호 필드 12 필수  
Vran 가상계좌번호 필드 20 필수  
MnrcStts 입금상태 필드 1 필수 1:정상, 0:처리중, 9:오류
MnrcDt 입금일자 필드 8 필수 YYYYMMDD
Mntmd 입금시각 필드 6 필수 HHMISS
MnChkTm 입금확인시각 필드 6 필수  
MnrcAmt 입금금액 필드 15 필수  

Request example

{
    "Header" : {
       "ApiNm" : "VirtualAccountReceivedListInquiry", 
       "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_001_00",
       "IsTuno" : "20180320100032000029",
       "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
   "Insymd" : "20180315",
   "Ineymd" : "20180315",
   "Vran" : "",
   "Lnsq" : "",
   "PageNo" : ""
}

Response example

{
   "Header" : {
   	   "ApiNm" : "VirtualAccountReceivedListInquiry",
   	   "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_001_00",
       "IsTuno" : "20180320100032000029",
       "Rpcd" : "00000",
       "Rsms" : "정상 처리 되었습니다."
    },
   "TotCnt" : "1",
   "IqtCnt" : "1",
   "PageNo" : "1",
    "Rec" : 
    [ {
           "Vran" : "79014238679123" 
           "MnrcStts" : "0",
           "Sqno" : "180315000001",
           "MnrcDt" : "20180315",
           "Mntmd" : "132810",
           "MnrcAmt" : "100"
    } ]
}