농협입금이체

기본정보

  • 기능 : 핀테크기업 약정계좌에서 고객 농협계좌로 입금합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : ReceivedTransferAccountNumber.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

농협입금이체 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
Bncd 은행코드 필드 3 필수 농협은행:011, 상호금융:012
Acno 계좌번호 필드 20 필수  
Tram 거래금액 필드 15 필수  
DractOtlt 출금계좌인자내용 필드 25 선택 출금계좌(입금이체 약정모계좌) 통장인자내용 or 고객명
MractOtlt 입금계좌인자내용 필드 25 선택 입금고객계좌 통장적용 인자내용
ex) 핀테크기업명 or 핀테크서비스명

응답

농협입금이체 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      

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

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

추가정보

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

Request example

{
"Header":{
    "ApiNm":"ReceivedTransferAccountNumber",
    "Tsymd":"20191129",
    "Trtm":"003544",
    "Iscd":"000019",
    "FintechApsno":"001",
    "ApiSvcCd":"ReceivedTransferA",
    "IsTuno":"201911290000000001",
    "AccessToken":
    "791c18f7377be31c8b30b27eba8573de0aac529890c7b18ac722f6120adc5054"},
    "Bncd":"011",
    "Acno":"3020000000109",
    "Tram":"200000",
    "DractOtlt":"테스트",
    "MractOtlt":"테스트" 
}

Response example

{	
    "Header": {
        "Trtm": "003544",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "ReceivedTransferAccountNumber",
        "IsTuno": "201911290000000001",
        "Tsymd": "20191129",
        "FintechApsno": "001",
        "Iscd": "000019",
        "Rpcd": "00000",
        "ApiSvcCd": "ReceivedTransferA"
    }
}