예치금관리용 가상계좌발급

기본정보

  • 기능 : 핀테크기업이 고객에게 부여하기 위해 가상계좌 발급을 요청한다.
  • 방식 : HTTPS-POST
  • 호출정보 : OpenVirtualAccount.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

예치금관리용 가상계좌발급 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
Dpnm 예금주명 필드 50 필수 - MAX: 한글 6자리
- 예금주명 앞에 기관 약어명(3자) 자동
추가 (총 9자리)
- 테스트에서는 예금주명

응답

예치금관리용 가상계좌발급 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
Dpnm 예금주명 필드 50 필수 테스트에서는 예금주명
VractPrtn 가상계좌유형 필드 1 필수 테스트에서는 "1"
Vran 가상계좌번호 필드 20 필수  
IsncRmngCnt 발급잔여건수 필드 10 필수  
IsncFncnt 발급완료건수 필드 10 필수  

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

투자금 지급지시 NH API 응답코드 및 업무처리 절차
응답코드 응답 메세지 업무처리 절차
- API 응답전문을 수신하지 못한 경우
(핀테크서비스에서 Time Out 경우)		 - 가상계좌 발급 API 재전송
(기존 기관거래고유번호)
AC082 기 처리된 기관거래고유번호입니다. 원거래 정보를 확인하려면 원거래정보와 동일하게 거래해주세요. - 가상계좌 발급 API 재전송 (원거래시 사용했던 정보를 동일하게 조립하여 재전송)

Request example

{                                                               
    "Header" : { 
       "ApiNm" : "OpenVirtualAccount",          
       "Tsymd" : "20221201",                       
       "Trtm" : "133259",                          
       "Iscd" : "000329",                           
       "FintechApsno" : "003",                             
       "ApiSvcCd" : "TEST_API_G",                      
       "IsTuno" : "20221201133259000001",
       "AccessToken" : "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
     },                                                         
     "Dpnm" : "홍길동"                    
}

Response example

{ 
    "Header":{
       "ApiNm" : "OpenVirtualAccount",
       "Tsymd" : "20221201",
       "Trtm" : "133259",
       "Iscd" : "000329",
       "FintechApsno" : "003",
       "ApiSvcCd" : "TEST_API_G",
       "IsTuno" : "20221201133259000001",
       "Rpcd" : "00000",
       "Rsms" : "정상 처리 되었습니다."
    }, 
    "Dpnm" : "홍길동",
    "VractPrtn" : "1",
    "Vran" : "79000000000001",
    "IsncRmngCnt" : "180",
    "IsncFncnt" : "20"
}