투자금 지급지시

기본정보

기능 : 투자금 모집 완료 후 차입자에게 대출을 시행합니다.
방식 : HTTPS-POST
호출정보 : P2PNInvestmentPaymentOrder.nh
호출결과 : JSON

NH API 입·출력 Layout

요청

투자금 지급지시 NH API 입 출력 Layout 요청
Element	한글명	Type	Length	optional	Description
Header		공통부
P2pCmtmNo	P2P약정번호	필드	20	필수
ChidSqno	자회사일련번호	필드	20	필수
SlctAmt	모집 금액	필드	15	필수	총 대출 금액
LonTrm	대출기간	필드	3	필수	개월 수 (1년일 경우 "12")
InvSumAmt	투자합계금액	필드	15	필수	반복부에 등록된 투자금액의 합계
NewTrnsYn	신규거래여부	필드	1	필수	신규 대출 : Y. 기존 대출 : N(차입자 계좌번호가 변경될 경우 N 거래 불가, 신규 대출번호로 전송)
LoanNo	대출번호	필드	13	필수	기관에서 채번하는 대출 고유 번호 (오픈플랫폼과 통신시에 사용하는 번호로 업체에서 관리하는 대출번호가 아님)
Bncd	은행코드	필드	3	필수
BrwAcno	차입자계좌번호	필드	20	필수
Dpnm	예금주명	필드	50	필수
LonApcYmd	대출신청일자	필드	8	필수	yyyymmdd
DractOtlt	출금계좌인자내용	필드	12	필수	대부업자회사 투자용 계좌에 입력될 인자 내용
MractOtlt	입금계좌인자내용	필드	14	선택	차입자 계좌에 입력될 인자 내용
Rec		반복부			500 건으로 제한 / 합계 금액 10억으로 제한
Vran	가상계좌번호	필드	20	필수	투자자 가상계좌번호
InvAmt	투자금액	필드	15	필수

응답

투자금 지급지시 NH API 입 출력 Layout 응답
Element	한글명	Type	Length	optional	Description
Header		공통부
P2pCmtmNo	P2P약정번호	필드	20	필수
ChidSqno	자회사일련번호	필드	20	필수
LoanNo	대출번호	필드	13	필수
InvAccAmt	누적투자금액	필드	15	필수	해당 대출번호에 대한 누적 투자 금액
InvSumAmt	투자합계금액	필드	15	필수	입력부 레코드의 투자 금액 합계

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

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

추가정보

본 API는 당일에 동일한 기관 거래고유번호로 전문을 전송할 경우, AC081 에러코드가 나감. 이때 결과는 결과확인전문 통해 결과 확인 해야 한다.
결과확인 API를 통해 본 거래의 원거래 기관거래고유번호를 개별부에 셋팅해서 결과확인이 가능하다.
해당 API 호출 시 반복부가 일정량을 넘어설 경우 타임아웃이 발생할 수 있어 반복부의 건수를 적당량으로 제한한다. (현재 500건)
해당 API 호출 시 투자합계 금액을 10억으로 제한하고 10억이 넘어갈경우 신규거래코드 “N”으로 다음거래를 진행한다.
그에 따라 신규거래 인지 기존거래의 다음 반복부를 송신하는 지에 대한 값이 신규거래여부와 대출번호 값이다. 대출번호는 플랫폼 기관의 각 대출에 대한 유니크한 값이며 같은 대출번호의 거래에 신규거래여부가 “Y” 가 될 수 없다. 그리고 차입자의 정보가 다른경우 신규거래 “Y”와 신규 대출번호로 진행되어야 한다.
반복부 건수 제한에 대해 각각의 API 호출 시 차입자에게도 대출금 지급은 각각 발생되나 대출에 대한 정보는 대출 번호로 함께 관리 된다.
에러코드 AT999, AC999, A9999, A9998, AP999와 같은 시스템 오류가 발생한 경우 반드시 거래가 정상적으로 처리됐는지 확인 해야 한다.(확인하지 않고 거래 진행시 중복거래 발생될 수 있음)

Request example

{
    "Header": {
    "ApiNm": "P2PNInvestmentPaymentOrder",
    "Tsymd": "20191212",
    "Trtm": "112428",
    "Iscd": "000013",
    "FintechApsno": "001",
    "ApiSvcCd": "13E_001_00",
    "IsTuno": "000011233213",
    "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "P2pCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "SlctAmt": "1000000000",
    "LonTrm": "12",
    "InvSumAmt": "1000000000",
    "NewTrnsYn": "Y",
    "LoanNo": "123465432",
    "Bncd": "011",
    "BrwAcno": "3020000000150",
    "Dpnm": "홍길동",
    "LonApcYmd": "20191212",
    "DractOtlt": "출금계좌인자내용",
    "MractOtlt": "입금계좌인자내용",
    "Rec": [{
    "Vran": "79000000000074",
    "InvAmt": "1000000000"
    }]
}

Response example

{
    
    
    "Header": {
        "Trtm": "112428",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "P2PNInvestmentPaymentOrder",
        "IsTuno": "000011233213",
        "Tsymd": "20191212",
        "FintechApsno": "001",
        "Iscd": "000013",
        "Rpcd": "00000",
        "ApiSvcCd": "13E_001_00"
    },
    "P2pCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "LoanNo": "123465432",
    "InvAccAmt": "1000000000",
    "InvSumAmt": "1000000000"
    
    
}