잔액조회

기본정보

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

NH API 입·출력 Layout

요청

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

응답

잔액조회 입 출력 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":"20160310",
        "Trtm":"144939",
        "Iscd":"12345",
        "FintechApsno":"001",
        "ApiSvcCd":"ReceivedTransferA",
        "IsTuno":"201603100000000001"},
    "FinAcno":"0082010123450011234567891239",	
}

Response example

{
    "Header":{	
        "ApiNm":"InquireBalance",
        "Tsymd":"20160310",
        "Trtm":"144939",
        "Iscd":"12345",
        "FintechApsno":"001",
        "ApiSvcCd":"DrawingTransferA",
        "IsTuno":"201603100000000001",
        "Rpcd":"00000",
        "Rsms ":"정상처리되었습니다"},
    "AthrCnfrTckt":"IHQ6FIPXoe9FFWdyMtveanBKqxLumL+YDnN64k78PKQrfF9vkFnljlYZvbFcCJy4z827",
    "WebUrl" : "https://dev.nonghyup.com:9620",
    "AndInltUrl" : "nh.openplatform.sign",
    "AndAppUrl" : "{"Action":"nh.openplatform.intent.OPENSIGN", "Compo………..",
    "AndWebUrl" : "{"SchemeUrl":"intent://sign", "Scheme":"openp………..",
    "IosInltUrl" : "http://itunes.apple.com/kr/app/xxxxx?mt=8",
    "IosAppUrl" : "nhopenplatform://?NHOPENPLATFORMSIGN“,
    "IosWebUrl" : "nhopenplatform://sign?NHOPENPLATFORMSIGN“,
    "FinAcno":"0082010123450011234567891239",	
    "Ldbl":"150000000",	
    "RlpmAbamt":"100000000",	
}