거래 결과 조회 API

결제(출금) 또는 송금 요청 후, 결과코드가 '처리중'이거나 응답 타임아웃이 발생한 경우 최종 성공/실패 여부를 확인하기 위해 호출합니다. 처리중 상태인 경우 일정 간격을 두고 반복 호출이 필요합니다.


API 정보

POST/v1/api/pay/morw
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/pay/morw
운영https://npay.settlebank.co.kr/v1/api/pay/morw

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
pktDivCdAN(2)영문+숫자, 최대 2byte*
업무구분 (RP: 출금, AR: 송금)
RP: 출금 AR: 송금
mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점 주문번호
mchtTrdDtAN(8)영문+숫자, 최대 8byte*
주문일자 (원거래 주문일자)
reqDtAN(8)영문+숫자, 최대 8byte*
요청일자 (현재 조회 요청일자)
reqTmAN(6)영문+숫자, 최대 6byte*
요청시간
pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + mchtTrdNo + mchtTrdDt + reqDt + reqTm + hashKey

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
outRsltCdAN(4)영문+숫자, 최대 4byte*0000
결과코드
outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
trdNoAN(40)영문+숫자, 최대 40byteSTFP_FIRM12345678901234567890
헥토파이낸셜 거래번호
bankCdAN(3)영문+숫자, 최대 3byte011
출금은행코드
svcDivCdN(1)숫자, 최대 1byte1
거래시 사용된 서비스
1: 펌뱅킹
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?