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

기본정보

  • 기능 : 투자예치금 반환 결과를 조회합니다.
  • 방식 : 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" : " P2PInvestmentDepositAmountReturnResultList"
          , "Tsymd" : "20170415"
          , "Trtm" : "151209"
          , "Iscd" : "000001"
          , "FintechApsno" : "001"
          , "ApiSvcCd" : "TEST_API_A"
          , "IsTuno" : "20170415151210000003"
        }
    
      , "P2pCmtmNo" : "000001P_0001"
      , "ChidSqno" : "000001-C0010"
      , "Vran" : "7901471991844"
    , "OrtrYmd" : "20170415"
      , "OrtrIsTuno" : "20170415143514000006"
    
    }

Response example

{
        "Trtm" : "151209"
      , "Rsms" : "정상 처리 되었습니다."
      , "ApiNm" : " P2PInvestmentDepositAmountReturnResultList"
      , "IsTuno" : "20170415151210000004"
      , "Tsymd" : "20170415"
      , "FintechApsno" : "001"
      , "Iscd" : "000001"
      , "Rpcd" : "00000"
      , "ApiSvcCd" : "TEST_API_A"
    }
, "P2pCmtmNo" : "000001P_0001"
  , "ChidSqno" : "000001-C0010"
  , "Vran" : "7901471991844"
, "Prtm" : "145230"
, “Pcrs” : “00000”
}