투자금예치금 반환결과조회

기본정보

  • 기능 : 투자예치금 반환 결과를 조회합니다.
  • 방식 : HTTPS-POST
  • 호출 정보 : P2PNInvestmentDepositAmountReturnResultList.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

투자금예치금 반환결과조회 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
P2pCmtmNo P2P약정번호 필드 20 필수  
ChidSqno 자회사일련번호 필드 20 필수  
Vran 가상계좌번호 필드 20 필수  
OrtrYmd 원거래일자 필드 8 필수  
OrtrIsTuno 원거래기관거래고유번호 필드 20 필수  

응답

투자금예치금 반환결과조회 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
P2pCmtmNo P2P약정번호 필드 20 필수  
ChidSqno 자회사일련번호 필드 20 필수  
Pcrs 처리결과 필드 5 필수 원거래에 대한 처리결과 ※공통부 Rpcd=‘00000’경우만 참조
처리 결과 코드
Prtm 처리시각 필드 6 필수  

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

투자금예치금 반환결과조회 NH API 특이사항 응답코드 및 업무처리 절차
응답코드 응답 메세지 업무처리 절차
A0284 반환요청이 처리중입니다. - 결과확인 API로 반환결과 확인

추가정보

  • 본 API는 당일에 동일한 기관 거래고유번호로 전문을 전송할 경우, AC081 에러코드가 나감. 이때 결과는 결과확인전문 통해 결과 확인 해야 한다.
  • 결과확인 API를 통해 본 거래의 원거래 기관거래고유번호를 개별부에 셋팅해서 결과확인이 가능하다.
  • 에러코드 AT999, AC999, A9999, A9998, AP999와 같은 시스템 오류가 발생한 경우 반드시 거래가 정상적으로 처리됐는지 확인 해야 한다.(확인하지 않고 거래 진행시 중복거래 발생될 수 있음)

Request example

{
    "Header": {
        "ApiNm": "P2PNInvestmentDepositAmountReturnResultList",
        "Tsymd": "20191212",
        "Trtm": "112428",
        "Iscd": "000013",
        "FintechApsno": "001",
        "ApiSvcCd": "13E_001_00",
        "IsTuno": "2130832759",
        "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "P2pCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "Vran": "79000000000074",
    "OrtrYmd": "20191212",
    "OrtrIsTuno": "324234234324"
}

Response example

{
    "Header": {
        "Trtm": "112428",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "P2PNInvestmentDepositAmountReturnResultList",
        "IsTuno": "2130832759",
        "Tsymd": "20191212",
        "FintechApsno": "001",
        "Iscd": "000013",
        "Rpcd": "00000",
        "ApiSvcCd": "13E_001_00"
    },
    "P2pCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "Pcrs": "00000",
    "Prtm": "201337"
    }