SettlePay.js API
내통장결제 결제창을 열기 위한 JavaScript SDK입니다. 스크립트를 로드한 뒤 SettlePay.execute()를 호출하면 디바이스 환경에 따라 팝업 또는 리다이렉트 방식으로 결제창이 열립니다.
스크립트 로드
환경에 맞는 스크립트를 <head> 또는 결제 버튼 이전에 삽입하세요.
<!-- 테스트베드 -->
<script src="https://tbezauth.settlebank.co.kr/js/SettlePay.js" charset="UTF-8"></script>
<!-- 상용 환경 -->
<script src="https://ezauth.settlebank.co.kr/js/SettlePay.js" charset="UTF-8"></script>
메서드
| 메서드 | 설명 |
|---|---|
SettlePay.execute(form) | 권장. 모바일이면 self(), PC이면 popup()을 자동으로 호출합니다. |
SettlePay.pay(form) | form의 viewType 필드값(popup / self)에 따라 분기합니다. |
SettlePay.popup(form) | PC 팝업 방식으로 결제창을 엽니다. |
SettlePay.self(form) | 현재 창에서 리다이렉트 방식으로 결제창을 엽니다. |
SettlePay.cashRcptInfo(form) | 현금영수증 정보 조회창을 엽니다. |
NOTE
execute() 권장
별도 분기 처리 없이 SettlePay.execute()를 사용하면 SDK가 UA를 감지해 모바일/PC 방식을 자동으로 선택합니다.
기본 사용 예시
<form id="payForm" name="payForm">
<input type="hidden" name="hdInfo" value="IA_AUTHPAGE_1.0_1.0" />
<input type="hidden" name="apiVer" value="2.0" />
<input type="hidden" name="processType" value="D" />
<input type="hidden" name="mercntId" value="[상점아이디]" />
<input type="hidden" name="ordNo" value="[주문번호]" />
<input type="hidden" name="trDay" value="[거래일자]" />
<input type="hidden" name="trTime" value="[거래시각]" />
<input type="hidden" name="trPrice" value="[AES-256 암호화된 금액]" />
<input type="hidden" name="productNm" value="[상품명]" />
<input type="hidden" name="dutyFreeYn" value="N" />
<input type="hidden" name="callbackUrl" value="[콜백 URL]" />
<input type="hidden" name="signature" value="[SHA-256 해쉬값]" />
</form>
<script>
SettlePay.execute(document.getElementById('payForm'));
</script>
파라미터 상세 및 응답 규격은 결제인증 API 문서를 참고하세요.
