원리금상환

기본정보

  • 기능 : 차입자 원리금 상환 시 상환금을 예치 계좌로 입금합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : P2PNInterestRepayment.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

원리금 상환 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
P2pCmtmNo P2P약정번호 필드 20 필수  
ChidSqno 자회사일련번호 필드 20 필수  
LoanNo 대출번호 필드 13 필수 기관에서 채번하는 대출 고유 번호
RpaySumAmt 상환합계금액 필드 15 필수 반복부 상환 금액의 합계
RpayYmd 상환일자 필드 8 필수 상환일자(API 호출 일자 : 금일)
DractOtlt 출금계좌인자내용 필드 12 선택 대부업자회사 계좌에서 출금시 계좌에 입력될 인자내용
MractOtlt 입금계좌인자내용 필드 14 선택  
Rec   반복부     500 건으로 제한 / 합계 금액 10억으로 제한
Vran 가상계좌번호 필드 20 필수  
RpayAmt 상환금액 필드 15 필수 가상계좌 별 상환된 금액

응답

원리금상환 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 로 결과 확인
- 동일오류 지속 발생시 은행 문의 필요
AT998 기타 오류가 발생하였습니다. - P2P 원리금 입금결과조회 API 로 결과 확인
- 동일오류 지속 발생시 은행 문의 필요
AC081 기 처리된 기관거래고유번호 입니다. 이체결과확인전문을 통해 이체결과를•확인하여 주시기 바랍니다. - P2P 원리금 입금결과조회 API 로 결과 확인

추가정보

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

Request example

{
    "Header": {
    "ApiNm": "P2PNInterestRepayment",
    "Tsymd": "20191212",
    "Trtm": "112428",
    "Iscd": "000013",
    "FintechApsno": "001",
    "ApiSvcCd": "13E_001_00",
    "IsTuno": "117688567532387",
    "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
    "P2pCmtmNo": "0000000000",
    "ChidSqno": "0000000000",
    "LoanNo": "123465432",
    "Vran": "79000000000076",
    "RpaySumAmt": "100000000",
    "RpayYmd": "20191212",
    "DractOtlt": "출금계좌인자내용",
    "MractOtlt": "입금계좌인자내용",
    "Rec":[ {
    "Vran": "79000000000074",
    "RpayAmt": "100000000"
    }]
}

Response example

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