SettlePay.js SDK

JavaScript SDK for launching the EZAuth Bank Transfer checkout. Load the script and call SettlePay.execute() — the SDK automatically selects popup or redirect mode based on the device.

Script Loading

Add the appropriate script to your <head> or before the payment trigger button.

<!-- Sandbox -->
<script src="https://tbezauth.settlebank.co.kr/js/SettlePay.js" charset="UTF-8"></script>

<!-- Production -->
<script src="https://ezauth.settlebank.co.kr/js/SettlePay.js" charset="UTF-8"></script>

Methods

Method	Description
`SettlePay.execute(form)`	Recommended. Automatically calls `self()` on mobile and `popup()` on desktop.
`SettlePay.pay(form)`	Branches based on the `viewType` field value in the form (`popup` / `self`).
`SettlePay.popup(form)`	Opens the checkout in a popup window (desktop).
`SettlePay.self(form)`	Opens the checkout via full-page redirect in the current window.
`SettlePay.cashRcptInfo(form)`	Opens the cash receipt inquiry UI.

NOTE

Use execute() for Simplicity

SettlePay.execute() detects the user agent and selects the appropriate mode automatically, eliminating the need for manual device branching.

Basic Usage

<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="[Merchant ID]" />
  <input type="hidden" name="ordNo"       value="[Order Number]" />
  <input type="hidden" name="trDay"       value="[Transaction Date]" />
  <input type="hidden" name="trTime"      value="[Transaction Time]" />
  <input type="hidden" name="trPrice"     value="[AES-256 Encrypted Amount]" />
  <input type="hidden" name="productNm"   value="[Product Name]" />
  <input type="hidden" name="dutyFreeYn"  value="N" />
  <input type="hidden" name="callbackUrl" value="[Callback URL]" />
  <input type="hidden" name="signature"   value="[SHA-256 Hash]" />
</form>

<script>
  SettlePay.execute(document.getElementById('payForm'));
</script>

For the full parameter specification and callback response format, see the Payment Authentication API reference.

Next Steps

Payment Authentication Parameters

Full request and response parameter reference

Full Integration Flow

Step-by-step guide from authentication to capture

Need technical support?

Code Samples

HectoFinancial GitHub