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

기본정보

  • 기능 : 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": "P2PNVirtualAccountNumberRequest",
        "Tsymd": "20191212",
        "Trtm": "112428",
        "Iscd": "000013",
        "FintechApsno": "001",
        "ApiSvcCd": "13E_001_00",
        "IsTuno": "123243240",
        "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "P2PCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "P2PVractUsg": "1",
    "InvstBrwNm": "홍길동"
}

Response example

{
    "Header": {
        "Trtm": "112428",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "P2PNVirtualAccountNumberRequest",
        "IsTuno": "123243240",
        "Tsymd": "20191212",
        "FintechApsno": "001",
        "Iscd": "000013",
        "Rpcd": "00000",
        "ApiSvcCd": "13E_001_00"
    },
    "P2PCmtmNo": "0000000000",
    "P2PVractUsg": "1",
    "Vran": "79000000000081",
    "ChidSqno": "0000000000",
    "InvstBrwNm": "홍길동"
}