투자금관리용 가상계좌발급

기본정보

  • 기능 : P2P 투자금 관리용 가상계좌를 발급합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : P2PNVirtualAccountNumberRequest.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

투자금관리용 가상계좌발급 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
P2pCmtmNo P2P약정번호 필드 20 필수  
P2PVractUsg P2P가상계좌 구분코드 필드 1 필수 1:투자자용, 2:차입자용
ChidSqno 자회사일련번호 필드 20 필수  
InvstBrwNm 투자자및차입자명 필드 50 필수 - MAX: 한글 6자리
- 예금주명 앞에 기관 약어명(3자) 자동
추가 (총 9자리)

응답

투자금관리용 가상계좌발급 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
P2pCmtmNo P2P약정번호 필드 20 필수  
ChidSqno 자회사일련번호 필드 20 필수  
Vran 가상계좌번호 필드 20 필수  
P2PVractUsg P2P가상계좌 구분코드 필드 1 필수  
InvstBrwNm 투자자및차입자명 필드 50 필수  

Request example

{
    "Header" : 
    {
        "ApiNm" : "P2PVirtualAccountNumberRequest"
        , "Tsymd" : "20170413"
        , "Trtm" : "134144"
        , "Iscd" : "000001"
        , "FintechApsno" : "001"
        , "ApiSvcCd" : "TEST_API_A"
        , "IsTuno" : "20170413134147000028"
    }

    , "P2pCmtmNo" : "000001P_0001"
    , "ChidSqno" : "000009-C0010"
    , "InvstNm" : "홍길동"
}

Response example

{
    "P2pCmtmNo" : "000001P_0001"
    , "InvstNm" : "홍길동"
    , "Vran" : "7901471991843"
    , "ChidSqno" : "000009-C0010"
    , "Header" : 
    {
        "Trtm" : "134144"
        , "Rsms" : "정상 처리 되었습니다."
        , "ApiNm" : "P2PVirtualAccountNumberRequest"
        , "IsTuno" : "20170413134147000028"
        , "Tsymd" : "20170413"
        , "FintechApsno" : "001"
        , "Iscd" : "000001"
        , "Rpcd" : "00000"
        , "ApiSvcCd" : "TEST_API_A"
    }
}