거래 결과 조회 API
결제승인결과 및 송금요청 결과에서 결과코드를 '처리중'으로 받았을 경우 또는 타임아웃이 발생한 경우 '성공' 혹은 '실패' 코드를 수신 할 때 까지 해당 API를 반복적으로 호출하여야 합니다.
거래(송금/출금)와 거래 결과조회의 API간 호출 간격이 너무 짧을 경우 잘못된 응답을 받을 수 있으므로, 처리중 또는 타임아웃이 발생한 이 후 10분 뒤 사용하는 것을 권장합니다.
API 정보
POST/v1/api/pay/morw
Content-Type
application/json테스트
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
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점주문번호
상점주문번호
*한글제외. 거래요청시 주문번호
└mchtTrdDtAN(8)영문+숫자, 최대 8byte*주문일자
주문일자
*yyyyMMdd
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자
요청일자
*yyyyMMdd
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간
요청시간
*HH24MISS
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
*상점아이디 + 주문번호 + 주문일자 + 요청일자 + 요청시간 + 인증키
요청 전문 해쉬 코드
| 항목 | 조합 필드 |
|---|---|
| pktHash 값 | 상점아이디 + 주문번호 + 주문일자 + 요청일자 + 요청시간 + 인증키 |
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)
거래상태코드 (성공/실패)
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
거절코드
*거절코드 테이블 참조
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└trdNoAN(40)영문+숫자, 최대 40byte헥토파이낸셜 거래번호
STFP_FIRM12345678901234567890헥토파이낸셜 거래번호
└bankCdN(3)숫자, 최대 3byte출금은행코드
011출금은행코드
└svcDivCdN(1)숫자, 최대 1byte거래시 사용된 서비스
거래시 사용된 서비스
1: 펌뱅킹 2: 오픈뱅킹요청 예시
{
"hdInfo": "SPAY_LT00_1.0",
"mchtId": "midtest",
"pktDivCd": "RP",
"mchtTrdNo": "OID201902210001",
"mchtTrdDt": "20191231",
"reqDt": "20191231",
"reqTm": "120000",
"pktHash": "해시값"
}
응답 예시
{
"outStatCd": "0021",
"outRsltCd": "0000",
"outRsltMsg": "정상처리되었습니다.",
"trdNo": "STFP_FIRM12345678901234567890",
"bankCd": "011",
"svcDivCd": "2"
}
