헥토파이낸셜 개발자센터

내통장 거래내역조회 API

거래건에 대한 상세 이력을 조회하는 API입니다.

테스트용 키 정보

API 정보

POST/v3/APITrInfo.do
Content-Typeapplication/json; charset=UTF-8
테스트https://tbezauthapi.settlebank.co.kr/v3/APITrInfo.do
운영https://ezauthapi.settlebank.co.kr:8081/v3/APITrInfo.do

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문 정보 코드
*고정값
└apiVerAN(4)영문+숫자, 최대 4byte*
전문 버전
*고정값
└mercntIdAN(8)영문+숫자, 최대 8byte*
상점아이디
└trDayN(8)숫자, 최대 8byte*
거래일자 (주문 시 생성한 거래일자)
└ordNoAN(100)영문+숫자, 최대 100byte*
주문번호
└reqDayN(8)숫자, 최대 8byte*
요청일자 (yyyyMMdd)
└reqTimeN(6)숫자, 최대 6byte*
요청시간 (HH24MISS)
└signatureAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mercntId + ordNo + trDay + reqDay + reqTime + hashKey

응답 파라미터

└resultCdN(1)숫자, 최대 1byte*0
결과코드
0: 성공 -1: 실패
└errCdAN(5)영문+숫자, 최대 5byte*0000
실패코드
└resultMsgAN(200)영문+숫자, 최대 200byte*성공
결과 메시지
└trCntN(4)숫자, 최대 4byte*1
거래내역건수
└trListObject List*[{"trStatus": "0021", ...}]
거래내역 리스트

trList 상세 필드

└trStatusAN(4)영문+숫자, 최대 4byte*0021
거래상태 (0021/3010/0: 성공, 0031: 실패, 0011: 출금요청중, 0051: 환불처리중)
└errCdAN(5)영문+숫자, 최대 5byte*
실패코드
└trTypeAN(2)영문+숫자, 최대 2byte*RP
거래구분 (RP: 결제, RT: 취소)
└trDayN(8)숫자, 최대 8byte*20190221
거래일자
└trTimeN(6)숫자, 최대 6byte*142120
거래시간
└bankCdN(3)숫자, 최대 3byte*001
출금은행코드
└trPriceN(13)숫자, 최대 13byte*1000
거래금액
└discntPriceN(13)숫자, 최대 13byte*0
할인금액
└payPriceN(13)숫자, 최대 13byte*10000
결제금액
└criPriceN(13)숫자, 최대 13byte*13000
현금영수증 발급 금액
└criTaxVatPriceN(13)숫자, 최대 13byte*11000
현금영수증 과세 금액 (부가세 포함)
└criDutyFreePriceN(13)숫자, 최대 13byte*2000
현금영수증 비과세 금액
└ordNoAN(100)영문+숫자, 최대 100byte*OID201902210001
주문번호
└trNoAN(50)영문+숫자, 최대 50byte*STFP_PNPTms00001t00220922182409M1962430
헥토파이낸셜 거래번호
└custParam1AN(128)영문+숫자, 최대 128byte
가맹점추가필드 1
└custParam2AN(128)영문+숫자, 최대 128byte
가맹점추가필드 2
└custParam3AN(128)영문+숫자, 최대 128byte
가맹점추가필드 3
└custParam4AN(128)영문+숫자, 최대 128byte
가맹점추가필드 4
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?