핀-어카운트 직접발급

기본정보

  • 기능 : 핀테크기업이 고객으로부터 직접 접수한 농협계좌에 대해 핀-어카운트 발급을 요청합니다.
  • 방식 : HTTPS-POST
  • 호출정보 : OpenFinAccountDirect.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

핀어카운트 직접발급 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
DrtrRgyn 출금이체 등록 여부 필드 1 필수 Y:등록, N:미등록
BrdtBrno 생년월일(사업자번호) 필드 10 필수 개인:YYYYMMDD
기업:사업자번호
Bncd 은행코드 필드 3 필수 농협은행:011, 상호금융:012
Acno 계좌번호 필드 20 필수 NH농협 계좌에 대해서만 발급 가능

응답

핀어카운트 직접발급 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
Rgno 등록번호 필드 20 필수  

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

핀어카운트 직접발급 NH API 응답코드 및 업무처리 절차
응답코드 응답 메세지 업무처리 절차
- API 응답전문을 수신하지 못한 경우
(핀테크서비스에서 Time Out 경우)		 - 핀-어카운트 직접발급/직접발급(ERP구축형)
- API 재전송(기존 기관거래고유번호)
AT999 타임아웃이 발생하였습니다. 출금이체, 입금이체 거래시 결과확인거래로, 발급 거래시 에는 원거래로 확인하여 주시기 바랍니다. - 핀-어카운트 직접발급/직접발급(ERP구축형) API 재처리
A0082 처리 중 입니다. - 핀-어카운트 직접발급/직접발급(ERP구축형)
API 재처리(원거래 응답이 나가기 전에 재처리 API 송신 경우)

추가정보

  • 본 API는 응답에서 수신받은 등록번호를 이용하여, 핀-어카운트 발급확인 API를 호출하여 최종 핀-어카운트를 발급받을 수 있다.

Request example

{
    "Header": {
        "ApiNm": "OpenFinAccountDirect",
        "Tsymd": "20191129",
        "Trtm": "113604",
        "Iscd": "900001",
        "FintechApsno": "001",
        "ApiSvcCd": "DrawingTransferA",
        "IsTuno": "201911290000000001",
        "AccessToken": "6500e3a81fe2deafd996ea437b6a4b7cfbd04a3ab7e26480b431fdf3ccf3b39b"
    },
    "DrtrRgyn": "Y",
    "BrdtBrno": "20191029",
    "Bncd": "011",
    "Acno": "3020000000039" 
}

Response example

{
    "Header": {
        "Trtm": "003544",
        "Rsms": "정상처리 되었습니다.",
        "ApiNm": "OpenFinAccountDirect",
        "IsTuno": "201911290000000001",
        "Tsymd": "20191101",
        "FintechApsno": "001",
        "Iscd": "900001",
        "Rpcd": "00000",
        "ApiSvcCd": "DrawingTransferA"
    },
    "Rgno": "20191124000000249"
}