결제대금 지급계좌 이체요청

기본정보

  • 기능 : 결제대금 지급을 위해 농협 예치계좌에서 기관 약정계좌로 입금한다.
  • 방식 : HTTPS-POST
  • 호출정보 : PaymentPayoutAccountTransfer.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

결제대금 지급계좌 이체요청 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
Tram 거래금액 필드 15 필수  
Acno 계좌번호 필드 20 필수 기관 약정계좌 (농협 모계좌)

응답

결제대금 지급계좌 이체요청 NH API 입 출력 Layout 응답
Element 한글명 Type Length optional Description
Header   공통부      
Rgno 등록번호 필드 20 필수 결제대금 지급요청시 사용
Tram 거래금액 필드 15 필수  

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

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

추가정보

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

Request example

{
    "Header" : {
       "ApiNm" : "PaymentPayoutAccountTransfer",
       "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_002_00",
       "IsTuno" : "20180320100032000008",
       "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
   "Tram" : "100",
   "Acno" : "06001019975"
}

Response example

{
  "Header" : {
       "ApiNm" : "PaymentPayoutAccountTransfer",
       "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_002_00",
       "IsTuno" : "20180320100032000008",
       "Rpcd" : "00000",
       "Rsms" : "정상 처리 되었습니다."
    },
    "Rgno" : "NO_1803200000042",
    "Tram" : "100"
}