거래 내역 조회 API
주문일자와 주문번호를 기준으로 결제 및 환불 내역을 조회합니다.
API 정보
POST/v1/api/pay/translist
Content-Type
application/json; charset=UTF-8테스트
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: 취소)
업무구분 (RP: 결제, RT: 취소)
RP: 결제 RT: 취소└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
상점 주문번호
└mchtTrdDtAN(8)영문+숫자, 최대 8byte*주문일자
주문일자
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자
요청일자
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간
요청시간
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtTrdNo + mchtTrdDt + reqDt + reqTm + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
└outRsltCdAN(4)영문+숫자, 최대 4byte*결과코드
0000결과코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└dataCntN(4)숫자, 최대 4byte*거래내역 건수
10거래내역 건수
└trRecordsObject List*거래내역 리스트
[{"recordOutRsltCd":"ST00", "recordMchtTrdNo":"OID203739450"}]거래내역 리스트
trRecords 상세 필드
└recordOutRsltCdAN(4)영문+숫자, 최대 4byte*거래결과코드
ST00거래결과코드
└recordOutRsltMsgAN(200)영문+숫자, 최대 200byte*거래결과메시지
성공거래결과메시지
└recordOutStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (0021: 성공, 0031: 실패)
0021거래상태코드 (0021: 성공, 0031: 실패)
└recordPktDivCdAN(2)영문+숫자, 최대 2byte*거래구분 (RP: 결제, RT: 취소)
RP거래구분 (RP: 결제, RT: 취소)
└recordMchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
OID203739450상점 주문번호
└recordTrdNoAN(40)영문+숫자, 최대 40byte헥토파이낸셜 거래번호
STFP_PNPTms00001t00220922182409M1962430헥토파이낸셜 거래번호
└recordTrdDtAN(8)영문+숫자, 최대 8byte*거래일자 (yyyyMMdd)
20210820거래일자 (yyyyMMdd)
└recordTrdAmtN(13)숫자, 최대 13byte*거래금액
1000거래금액
└recordBankCdAN(3)영문+숫자, 최대 3byte*출금은행코드
011출금은행코드
└recordCustAcntNoAN(15)영문+숫자, 최대 15byte*출금은행계좌 (계좌번호 마스킹 처리)
831*******11출금은행계좌 (계좌번호 마스킹 처리)
└recordSvcDivCdN(1)숫자, 최대 1byte거래시 사용된 서비스
1거래시 사용된 서비스
1: 펌뱅킹
