투자예치금 반환요청

기본정보

기능 : 투자자가 예치한 금액을 반환합니다.
방식 : HTTPS-POST
호출정보 : P2PNInvestmentDepositAmountReturn.nh
호출결과 : JSON

NH API 입·출력 Layout

요청

투자예치금 반환요청 NH API 입 출력 Layout 요청
Element	한글명	Type	Length	optional	Description
Header		공통부
P2pCmtmNo	P2P약정번호	필드	20	필수
ChidSqno	자회사일련번호	필드	20	필수
Vran	가상계좌번호	필드	20	필수
RtnAmt	반환금액	필드	15	필수
Bncd	은행코드	필드	3	필수
Dpnm	예금주명	필드	50	필수
IvstrAcct	투자자계좌번호	필드	20	필수
MractOtlt	입금계좌인자내용	필드	14	필수	차입자 계좌에 입력될 인자 내용

응답

투자예치금 반환요청 NH API 입 출력 Layout 응답
Element	한글명	Type	Length	optional	Description
Header		공통부

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

투자예치금 반환요청 NH API 특이사항 응답코드 및 업무처리 절차
응답코드	응답 메세지	업무처리 절차
-	API 응답전문을 수신하지 못한 경우 (핀테크서비스에서 Time Out 경우)	- P2P투자예치금반환결과조회 API로 결과확인 - 동일오류 지속 발생시 은행 문의 필요
AT999	타임아웃이 발생하였습니다. 출금이체, 입금이체 거래시 결과확인거래로, 발급 거래시 에는 원거래로 확인하여 주시기 바랍니다.	- P2P투자예치금반환결과조회 API로 결과확인
AC999 A9999	오픈플랫폼 처리중 오류가 발생하였습니다.	- P2P투자예치금반환결과조회 API로 결과확인 - 동일오류 지속 발생시 은행 문의 필요
A9998	기타 오류가 발생하였습니다.	- P2P투자예치금반환결과조회 API로 결과확인 - 동일오류 지속 발생시 은행 문의 필요
AC081	기 처리된 기관거래고유번호 입니다. 이체결과확인전문을 통해 이체결과를•확인하여 주시기 바랍니다.	- P2P투자예치금반환결과조회 API로 결과확인
AC073	투자예치금 반환 요청 시 투자금 입금 후 3시간 이후에 출금가능합니다	- P2P투자예치금반환결과조회 API로 결과확인 - 동일오류 지속 발생시 은행 문의 필요

추가정보

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

Request example

{
  "Header": {
    "ApiNm": "P2PNInvestmentDepositAmountReturn",
    "Tsymd": "20191212",
    "Trtm": "112428",
    "Iscd": "000013",
    "FintechApsno": "001",
    "ApiSvcCd": "13E_001_00",
    "IsTuno": "324234234324",
    "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
  },
  "P2pCmtmNo": "0000000000",
  "ChidSqno": "0000000000",
  "Vran": "79000000000074",
  "RtnAmt": "100000000",
  "Bncd": "011",
  "Dpnm": "홍길동",
  "IvstrAcct": "3020000000150",
  "MractOtlt": "입금계좌인자내용"
}

Response example

{
	"Header": {
	    "Trtm": "112428",
	    "Rsms": "정상처리 되었습니다.",
	    "ApiNm": "P2PNInvestmentDepositAmountReturn",
	    "IsTuno": "324234234324",
	    "Tsymd": "20191212",
	    "FintechApsno": "001",
	    "Iscd": "000013",
	    "Rpcd": "00000",
	    "ApiSvcCd": "13E_001_00"
	}
}