현금영수증발행조회 (UI) API
내통장결제를 통하여 현금영수증을 발급한 경우 해당 UI 연동을 통하여 현금영수증 정보를 확인할 수 있습니다.
테스트용 키 정보
연동 스크립트
| 구분 | URL |
|---|---|
| 테스트베드 | https://tbezauth.settlebank.co.kr/js/SettlePay.js |
| 상용 환경 | https://ezauth.settlebank.co.kr/js/SettlePay.js |
SettlePay.cashRcptInfo(form);
결제창 연동과 동일하게 스크립트를 통해 UI를 호출합니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문 정보 코드
전문 정보 코드
*고정값
└apiVerAN(4)영문+숫자, 최대 4byte*전문 버전
전문 버전
*고정값
└mercntIdAN(8)영문+숫자, 최대 8byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└ordNoAN(100)영문+숫자, 최대 100byte*가맹점에서 생성한 고유 주문번호 (동일 거래일자에 유일성을 보장해야 함)
가맹점에서 생성한 고유 주문번호 (동일 거래일자에 유일성을 보장해야 함)
└trNoAN(50)영문+숫자, 최대 50byte*헥토파이낸셜에서 생성한 결제 거래번호
헥토파이낸셜에서 생성한 결제 거래번호
└trDayN(8)숫자, 최대 8byte*거래일자 (yyyyMMdd)
거래일자 (yyyyMMdd)
└signatureAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
mercntId + ordNo + trNo + trDay + hashKey
연동 예시
<form id="cashRcptForm" method="POST">
<input type="hidden" name="hdInfo" value="IA_CASHRCPTINFO_1.0_1.0" />
<input type="hidden" name="apiVer" value="1.0" />
<input type="hidden" name="mercntId" value="ms00003t" />
<input type="hidden" name="ordNo" value="OID201902210001" />
<input type="hidden" name="trNo" value="STFP_PNPTms00001t00220922182409M1962430" />
<input type="hidden" name="trDay" value="20260107" />
<input type="hidden" name="signature" value="해시값" />
</form>
<script src="https://tbezauth.settlebank.co.kr/js/SettlePay.js" charset="UTF-8"></script>
<script>
SettlePay.cashRcptInfo(document.getElementById('cashRcptForm'));
</script>
NOTE
현금영수증 조회 화면
해당 API를 호출하면 현금영수증 발급 정보(발급일시, 승인번호, 발급금액 등)를 확인할 수 있는 UI가 표시됩니다.
