결제대금 지급요청

기본정보

  • 기능 : 결제대금 지급을 위해 기관 약정계좌에서 고객 계좌로 이체한다.
  • 방식 : HTTPS-POST
  • 호출정보 : PaymentPayoutReceivedTransfer.nh
  • 호출결과 : JSON

NH API 입·출력 Layout

요청

결제대금 지급요청 NH API 입 출력 Layout 요청
Element 한글명 Type Length optional Description
Header   공통부      
Rgno 등록번호 필드 20 필수  
Tram 거래금액 필드 15 필수  
Bncd 은행코드 필드 3 필수  
Acno 계좌번호 필드 20 필수  
DractOtlt 출금계좌인자내용 필드 25 선택 출금계좌(약정계좌) 통장인자내용 or 고객명
MractOtlt 입금계좌인자내용 필드 25 선택 입금고객계좌 통장인자내용

응답

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

Request example

{
    "Header" :  {
       "ApiNm" : "PaymentPayoutReceivedTransfer",
       "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_003_00",
       "IsTuno" : "20180320100032000013",
       "AccessToken": "10b74dd7f5f0f521ecdc7ade82f793bdfc119c3635d2e5303ae6aba0c93d4246"
    },
   "Rgno" : "NO_1803200000044",
   "Tram" : "100",
   "Bncd" : "011",
   "Acno" : "3170003417501",
   "DractOtlt" : "출금계좌인자내용",
   "MractOtlt" : "입금계좌인자내용"
}

Response example

{
    "Header" : {
       "ApiNm" : "PaymentPayoutReceivedTransfer",
       "Tsymd" : "20180320",
       "Trtm" : "100030",
       "Iscd" : "000001",
       "FintechApsno" : "011",
       "ApiSvcCd" : "10B_003_00",
       "IsTuno" : "20180320100032000013",
       "Rpcd" : "00000",
       "Rsms" : "정상 처리 되었습니다."
    }
}