거래내역조회 API
결제 및 환불에 관한 거래 내역을 요청합니다.
가맹점의 주문일자, 주문 번호로 거래(결제/환불)에 대한 정보를 확인 할 수 있습니다.
API 정보
POST/v1/api/pay/translist
Content-Type
application/json테스트
https://tbnpay.settlebank.co.kr/v1/api/pay/translist운영
https://npay.settlebank.co.kr/v1/api/pay/translist요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└pktDivCdAN(2)영문+숫자, 최대 2byte*업무구분
업무구분
RP: 결제 RT: 취소*주문번호의 업무구분
└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(100)영문+숫자, 최대 100byte*결과메시지
정상처리되었습니다.결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└dataCntN(4)숫자, 최대 4byte*거래건수
10거래건수
*거래내역이 존재하는 경우
└trRecords<object>*거래내역
거래내역
└--recordOutRsltCdAN(4)영문+숫자, 최대 4byte*거래결과코드
ST00거래결과코드
*거절코드 테이블 참조
└--recordOutRsltMsgAN(200)영문+숫자, 최대 200byte*거래결과메시지
성공거래결과메시지
└--recordOutStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
거래상태코드
0021: 성공 0031: 실패└--recordPktDivCdAN(2)영문+숫자, 최대 2byte*거래구분
RP거래구분
RP: 결제 RT: 취소└--recordMchtTrdNoAN(100)영문+숫자, 최대 100byte*주문번호
OID203739450주문번호
*한글제외
└--recordTrdNoAN(40)영문+숫자, 최대 40byte헥토파이낸셜 거래번호
STFP_FIRM123454667789헥토파이낸셜 거래번호
└--recordTrdDtAN(8)영문+숫자, 최대 8byte*거래일자
20210820거래일자
*yyyymmdd
└--recordTrdAmtN(13)숫자, 최대 13byte*거래금액
1000거래금액
*출금할 금액(거래금액)
└--recordBankCdAN(3)영문+숫자, 최대 3byte*출금은행코드
011출금은행코드
└--recordCustAcntNoAN(15)영문+숫자, 최대 15byte*출금은행계좌
831*******11출금은행계좌
*계좌전호 마스킹 처리
└--recordSvcDivCdN(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": "정상처리되었습니다.",
"dataCnt": "1",
"trRecords": [
{
"recordOutRsltCd": "ST00",
"recordOutRsltMsg": "성공",
"recordOutStatCd": "0021",
"recordPktDivCd": "RP",
"recordMchtTrdNo": "OID203739450",
"recordTrdNo": "STFP_FIRM123454667789",
"recordTrdDt": "20210820",
"recordTrdAmt": "1000",
"recordBankCd": "011",
"recordCustAcntNo": "831*******11",
"recordSvcDivCd": "2"
}
]
}
