실시간 거래 조회 API
원거래의 상태를 실시간으로 조회합니다.
테스트용 키 정보
주의 사항
NOTE
결제수단 별 단건 거래상태 조회
원 거래 일자는 조회하고자 하는 원 거래 번호의 요청 당시 일자를 입력합니다. (해당 거래일 기준 전일 ~ 익일 사이 거래 건 조회)
- 원 거래 번호가 확인이 되는 경우 원 거래 번호(
orgTrdNo)를 추가 전달하면 보다 정확한 조회가 가능합니다.
API 정보
POST/spay/APITrdcheck.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APITrdcheck.do운영
https://gw.settlebank.co.kr/spay/APITrdcheck.do요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└verAN(4)영문+숫자, 최대 4byte*전문의 버전
전문의 버전
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 거래번호 (조회 요청 건)
상점에서 생성하는 고유한 거래번호 (조회 요청 건)
└trdDtN(8)숫자, 최대 8byte*현재 전문을 전송하는 일자 (YYYYMMDD)
현재 전문을 전송하는 일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*현재 전문을 전송하는 시간 (HHMMSS)
현재 전문을 전송하는 시간 (HHMMSS)
data 객체
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
*거래일자 + 거래시간 + 상점아이디 + 상점주문번호 + 거래금액(평문) + 해쉬키
└methodA(2)영문, 최대 2byte*결제수단 코드
결제수단 코드
WL: 화이트라벨*고정값
└trdAmtN(12)숫자, 최대 12byte*거래금액 (평문)
거래금액 (평문)
*1,000원 → 1000
└orgTrdDtN(8)숫자, 최대 8byte*원거래 결제 요청시 요청일자 (YYYYMMDD)
원거래 결제 요청시 요청일자 (YYYYMMDD)
└orgMchtTrdNoAN(100)영문+숫자, 최대 100byte*원거래의 상점주문번호
원거래의 상점주문번호
└orgTrdNoAN(40)영문+숫자, 최대 40byte결제 시, 헥토파이낸셜에서 발급한 거래번호
결제 시, 헥토파이낸셜에서 발급한 거래번호
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 고유 상점아이디
pg_test헥토파이낸셜에서 부여하는 고유 상점아이디
└verAN(4)영문+숫자, 최대 4byte*전문의 버전
0A1M전문의 버전
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*요청시의 주문번호 bypass
WLINFO20260107143000요청시의 주문번호 bypass
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호
STFP_PGCApg_test0000260107143000M1717578헥토파이낸셜 거래번호
└trdDtN(8)숫자, 최대 8byte*현재 전문을 전송하는 일자 (YYYYMMDD)
20260107현재 전문을 전송하는 일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*현재 전문을 전송하는 시간 (HHMMSS)
143000현재 전문을 전송하는 시간 (HHMMSS)
└outStatCdN(4)숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패*성공건 확인: 거래상태=0021 + 결과코드=0000
└outRsltCdAN(4)영문+숫자, 최대 4byte*결과코드
0000결과코드
0000: 정상거래 (가상계좌는 입금성공) 0001: 취소상태 (가상계좌는 환불상태) 0009: 결제실패*그 외 거절 코드 표 참고
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메세지
정상거래결과메세지
data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*요청시 hash 값 그대로 return
996E651D9435700D54E0D69B5726B5489AD0691C3FC86BE572314D39A2AE8B6D요청시 hash 값 그대로 return
└methodA(2)영문, 최대 2byte*결제수단 코드
WL결제수단 코드
WL: 화이트라벨└trdAmtN(12)숫자, 최대 12byte*거래금액
1000거래금액
└cnclAmtN(12)숫자, 최대 12byte취소금액 (취소 건 미존재 시 0원)
0취소금액 (취소 건 미존재 시 0원)
요청 예시
{
"params": {
"mchtId": "pg_test",
"ver": "0A1M",
"mchtTrdNo": "WLINFO20260107143000",
"trdDt": "20260107",
"trdTm": "143000"
},
"data": {
"pktHash": "996E651D9435700D54E0D69B5726B5489AD0691C3FC86BE572314D39A2AE8B6D",
"method": "WL",
"trdAmt": "1000",
"orgTrdDt": "20260107",
"orgMchtTrdNo": "ORDER20260107143000",
"orgTrdNo": "STFP_PGCApg_test0000260107143000M1717578"
}
}
응답 예시
{
"params": {
"mchtId": "pg_test",
"ver": "0A1M",
"mchtTrdNo": "WLINFO20260107143000",
"trdNo": "STFP_PGCApg_test0000260107143000M1717578",
"trdDt": "20260107",
"trdTm": "143000",
"outStatCd": "0021",
"outRsltCd": "0000",
"outRsltMsg": "정상거래"
},
"data": {
"pktHash": "996E651D9435700D54E0D69B5726B5489AD0691C3FC86BE572314D39A2AE8B6D",
"method": "WL",
"trdAmt": "1000",
"cnclAmt": "0"
}
}
