잔액조회

기본정보

  • 기능 : 핀-어카운트 연결계좌에 대한 잔액을 조회합니다.
  • 방식 : HTTPS-POST
  • 호출 정보 : InquireBalance.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

잔액조회 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
FinAcno 핀-어카운트 필드 30 필수  

응답

잔액조회 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
AthrCnfrTckt 권한확인티켓 필드 500 - AI001, AI002오류 발생시 출력됨
WebUrl 웹URL 필드 200 - AI001, AI002오류 발생시 출력됨
AndInltUrl 안드로이드설치URL 필드 200 - AI001, AI002오류 발생시 출력됨
AndAppUrl 안드로이드앱URL 필드 200 - AI001, AI002오류 발생시 출력됨
AndWebUrl 안드로이드웹URL 필드 200 - AI001, AI002오류 발생시 출력됨
IosInltUrl IOS설치URL 필드 200 - AI001, AI002오류 발생시 출력됨
IosAppUrl IOS앱URL 필드 200 - AI001, AI002오류 발생시 출력됨
IosWebUrl IOS웹URL 필드 200 - AI001, AI002오류 발생시 출력됨
FinAcno 핀-어카운트 필드 30 필수  
Ldbl 원장잔액 필드 15 필수  
RlpmAbamt 실지급가능액 필드 15 필수  

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": "InquireBalance",
        "Tsymd": "20191212",
        "Trtm": "112428",
        "Iscd": "000013",
        "FintechApsno": "001",
        "ApiSvcCd": "ReceivedTransferA",
        "IsTuno": "1233424",
        "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "FinAcno": "00820100000130000000000002067"
}

Response example

{
    "Header": {
        "Trtm": "112428",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "InquireBalance",
        "IsTuno": "1233424",
        "Tsymd": "20191212",
        "FintechApsno": "001",
        "Iscd": "000013",
        "Rpcd": "00000",
        "ApiSvcCd": "ReceivedTransferA"
    },
    "FinAcno": "00820100000130000000000002067",
    "Ldbl": "1100000000",
    "RlpmAbamt": "1100000000"
}