출금이체

기본정보

  • 기능 : 고객계좌에서 핀테크 기업 약정계좌로 핀-어카운트를 이용하여 출금합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : DrawingTransfer.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

출금이체 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
FinAcno 핀-어카운트 필드 30 필수  
Tram 거래금액 필드 15 필수  
DractOtlt 출금계좌인자내용 필드 25 선택 출금고객계좌 통장적용 인자내용
ex) 핀테크기업명 or 핀테크서비스명or 송금수취인
MractOtlt 입금계좌인자내용 필드 25 미사용 출금이체시에는 출금계좌인자 내용만사용

응답

출금이체 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
FinAcno 핀-어카운트 필드 30 필수  
RgsnYmd 등록일자 필드 8 필수  

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

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

추가정보

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

Request example

{	
    "Header":{
        "ApiNm":"DrawingTransfer",
        "Tsymd":"20191129",
        "Trtm":"125237",
        "Iscd":"900001",
        "FintechApsno":"001",
        "ApiSvcCd":"DrawingTransferA",
        "IsTuno":"201911290000000001", 
        "AccessToken": "6500e3a81fe2deafd996ea437b6a4b7cfbd04a3ab7e26480b431fdf3ccf3b39b"
    },
"FinAcno":"00820109000010001413",
"Tram":"1000000",
"DractOtlt":"테스트",
"MractOtlt":"테스트"
}

Response example

{	
    "Header": {
        "Trtm": "125237",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "DrawingTransfer",
        "IsTuno": "201911290000000001",
        "Tsymd": "20191129",
        "FintechApsno": "001",
        "Iscd": "900001",
        "Rpcd": "00000",
        "ApiSvcCd": "DrawingTransferA"
    },
    "FinAcno": "00820100000190001639",
    "RgsnYmd": "20191124"
}