헥토파이낸셜 개발자센터
ProductsProducts
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP server & AI chatbot
API & SDKAPI & SDK
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
블로그Blog
Service Status
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP 서버 및 AI 챗봇
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Blog
Technical blog & news
Service Status
Incidents and scheduled maintenance
Payment Gateway
Before You BeginServers & NetworkIntegration OverviewWebhooksCancellations & RefundsGo Live
Checkout IntegrationJavaScript SDKForm-Based Checkout Integration
Credit Card CheckoutCredit Card Direct APICredit Card WebhookCredit Card Deferred CaptureRegister Card (Billkey Checkout)Charge with Payment TokenDelete Payment TokenCancel Charge
Bank Transfer CheckoutBank Transfer WebhookBank Transfer Deferred CaptureCancel Bank Transfer
Virtual Account CheckoutVirtual Account Deposit WebhookIssue Virtual AccountFixed/Unlimited Virtual AccountModify Virtual AccountCancel Virtual AccountDeposit LookupRefund Virtual AccountSimulate Deposit
010 Virtual Account Overview010 Virtual Account CheckoutPhone Ownership Verification — RequestPhone Ownership Verification — ConfirmDuplicate Amount CheckIssue 010 Virtual AccountCancel 010 Virtual AccountRefund 010 Virtual Account010 Virtual Account Deposit WebhookSimulate 010 Deposit
Mobile Payment CheckoutMobile Payment WebhookMobile Payment — Two-Step CaptureMobile Recurring PaymentCancel Mobile PaymentRefund Mobile Payment
Gift Card CheckoutGift Card WebhookCancel Gift Card Payment
T-money CheckoutT-money WebhookCancel T-money Payment
Point Damoa CheckoutPoint Damoa WebhookPoint Damoa Deferred CaptureCancel Point Damoa Payment
Digital Wallets OverviewPAYCO CheckoutPAYCO SandboxSamsung Pay CheckoutKakaoPay CheckoutNaverPay CheckoutTossPay CheckoutDigital Wallet WebhookCancel Digital Wallet PaymentWallet Recurring PaymentSubscription StatusCancel Subscription
Real-time Transaction LookupReceipt (Sales Slip) Inquiry (No Auth)Receipt (Sales Slip) Inquiry (Auth)Transaction ReconciliationSettlement ReconciliationSub-Merchant RegistrationPreferential Settlement (SME)SME Refund Adjustment
Error CodesCard Issuer CodesBank CodesPayment Method CodesVirtual Account Bank Codes
My Bank Pay
Before You BeginServers & NetworkIntegration Overview
Checkout SDK
My Bank Pay — AuthenticateMy Bank Pay — CaptureMy Bank Pay — CancelMy Bank Pay — Network Cancel
Transaction Result LookupTransaction HistoryCash Receipt Lookup
Create Recurring TokenCharge via Recurring TokenCancel Subscription
Error CodesBank CodesBank Maintenance Schedule
Easy Cash Payment
Before You BeginServers & NetworkFirm Banking Integration Flow
Mobile Identity Verification — RequestMobile Identity Verification — ConfirmAccount Holder Name Lookup IAccount Holder Name Lookup IIAccount Holder Name (with Amount)Account Ownership VerificationAccount Ownership — RequestAccount Ownership — ConfirmIVR Verification — RequestIVR Verification — ConfirmOwnership Verification HistoryPayment PIN Verification
Register AccountDeregister AccountSelf-Service Account RegistrationKFTC Deregistered Account Lookup
Capture PaymentCancel / Refund PaymentSend RemittanceRemittance Account Balance
Create Recurring TokenCharge via Recurring TokenCancel SubscriptionSubscription DetailsSubscription History
Transaction Result LookupTransaction HistoryAccount ListSupported BanksBank Maintenance CheckOwnership Verification Bank MaintenanceConnectivity Test
Before You BeginServers & NetworkOpen Banking Integration Flow
Register AccountRegister Open Banking AccountDeregister Open Banking Service
Capture PaymentCancel PaymentSend Remittance
Submit Refund ClaimRefund Claim Status
Transaction Result LookupTransaction HistoryAccount ListWithdrawal Limit
Decline Code ReferenceBank Code ReferenceBank Maintenance Schedule
White-Label Payments
Before You BeginServers & NetworkIntegration Overview
Payment CheckoutCapture PaymentCancellations & Refunds
Inquiry
Error CodesBank CodesBank Maintenance Schedule
Cash Receipt
Before You BeginServers & NetworkIntegration Overview
Issue Cash ReceiptCancel Cash Receipt
Issuance Error LookupIssuance Status Lookup
Reprocessing RegistrationReprocessing Result Lookup
Reference
Firm Banking
Before You BeginIntegration Overview
Connection Management
Interbank TransferCollection TransferCollection Account SetupReserve Transfer (SC Bank)Trust Deposit (Woori Bank)
Transfer Failure WebhookTransaction Statement WebhookBill Statement WebhookBill Statement — Missing SequenceReserve Transfer Result Webhook (SC)Transfer Failure — Missing SequenceTransaction Detail — Missing Sequence
Account Holder Name LookupTransfer Result LookupBalance LookupReserve Transfer Result (SC)Auto Transfer Result (SC)
Transfer ReconciliationCollection ReconciliationWebhook Delivery Status
Connection Management
FX RemittanceCancel FX RemittanceFX Remittance Result WebhookFX Remittance Result — Missing SequenceFX Remittance (MX)FX Remittance Result Webhook (MX)FX Remittance — Missing Sequence (MX)
FX Same-Bank Holder LookupFX Account Holder LookupExchange Rate LookupExchange Rate Lookup (KEB)FX Remittance Result LookupFX Balance Lookup
FX Remittance ReconciliationFX Auto Transfer ReconciliationFX Same-Bank Remittance Reconciliation
FX Transaction Statement WebhookFX Transaction Statement — Missing Sequence
VAN Virtual Account
Getting Started with VAVSCommunication and Message FormatCommon Header
Recipient InquiryDeposit and Cancellation
RemittanceDeposit Balance Inquiry
Reconciliation
Account Holder InquiryActual Depositor NotificationActual Depositor FileMissing Actual Depositor InquiryWithdrawal Account Registration
Bank CodesResponse CodesChannel CodesBank Operating Hours
Prepaid Wallet
Before You BeginServers & NetworkIntegration Overview
Member Registration UIMy Account UI
Spend BalanceVoid SpendSend Money GiftRevoke Points
Balance LookupBalance OptionsBalance DetailsBalance by Top-upWithdrawable BalanceTransaction ListTransaction DetailsTransaction Details by StoreMember DetailsExpiring PointsTop-up Methods
Top-upCancel Top-upWithdraw FundsPending Withdrawal
Error CodesTransaction Type Codes

Tools

Encryption Test
Payment Gateway
Before You BeginServers & NetworkIntegration OverviewWebhooksCancellations & RefundsGo Live
Checkout IntegrationJavaScript SDKForm-Based Checkout Integration
Credit Card CheckoutCredit Card Direct APICredit Card WebhookCredit Card Deferred CaptureRegister Card (Billkey Checkout)Charge with Payment TokenDelete Payment TokenCancel Charge
Bank Transfer CheckoutBank Transfer WebhookBank Transfer Deferred CaptureCancel Bank Transfer
Virtual Account CheckoutVirtual Account Deposit WebhookIssue Virtual AccountFixed/Unlimited Virtual AccountModify Virtual AccountCancel Virtual AccountDeposit LookupRefund Virtual AccountSimulate Deposit
010 Virtual Account Overview010 Virtual Account CheckoutPhone Ownership Verification — RequestPhone Ownership Verification — ConfirmDuplicate Amount CheckIssue 010 Virtual AccountCancel 010 Virtual AccountRefund 010 Virtual Account010 Virtual Account Deposit WebhookSimulate 010 Deposit
Mobile Payment CheckoutMobile Payment WebhookMobile Payment — Two-Step CaptureMobile Recurring PaymentCancel Mobile PaymentRefund Mobile Payment
Gift Card CheckoutGift Card WebhookCancel Gift Card Payment
T-money CheckoutT-money WebhookCancel T-money Payment
Point Damoa CheckoutPoint Damoa WebhookPoint Damoa Deferred CaptureCancel Point Damoa Payment
Digital Wallets OverviewPAYCO CheckoutPAYCO SandboxSamsung Pay CheckoutKakaoPay CheckoutNaverPay CheckoutTossPay CheckoutDigital Wallet WebhookCancel Digital Wallet PaymentWallet Recurring PaymentSubscription StatusCancel Subscription
Real-time Transaction LookupReceipt (Sales Slip) Inquiry (No Auth)Receipt (Sales Slip) Inquiry (Auth)Transaction ReconciliationSettlement ReconciliationSub-Merchant RegistrationPreferential Settlement (SME)SME Refund Adjustment
Error CodesCard Issuer CodesBank CodesPayment Method CodesVirtual Account Bank Codes
My Bank Pay
Before You BeginServers & NetworkIntegration Overview
Checkout SDK
My Bank Pay — AuthenticateMy Bank Pay — CaptureMy Bank Pay — CancelMy Bank Pay — Network Cancel
Transaction Result LookupTransaction HistoryCash Receipt Lookup
Create Recurring TokenCharge via Recurring TokenCancel Subscription
Error CodesBank CodesBank Maintenance Schedule
Easy Cash Payment
Before You BeginServers & NetworkFirm Banking Integration Flow
Mobile Identity Verification — RequestMobile Identity Verification — ConfirmAccount Holder Name Lookup IAccount Holder Name Lookup IIAccount Holder Name (with Amount)Account Ownership VerificationAccount Ownership — RequestAccount Ownership — ConfirmIVR Verification — RequestIVR Verification — ConfirmOwnership Verification HistoryPayment PIN Verification
Register AccountDeregister AccountSelf-Service Account RegistrationKFTC Deregistered Account Lookup
Capture PaymentCancel / Refund PaymentSend RemittanceRemittance Account Balance
Create Recurring TokenCharge via Recurring TokenCancel SubscriptionSubscription DetailsSubscription History
Transaction Result LookupTransaction HistoryAccount ListSupported BanksBank Maintenance CheckOwnership Verification Bank MaintenanceConnectivity Test
Before You BeginServers & NetworkOpen Banking Integration Flow
Register AccountRegister Open Banking AccountDeregister Open Banking Service
Capture PaymentCancel PaymentSend Remittance
Submit Refund ClaimRefund Claim Status
Transaction Result LookupTransaction HistoryAccount ListWithdrawal Limit
Decline Code ReferenceBank Code ReferenceBank Maintenance Schedule
White-Label Payments
Before You BeginServers & NetworkIntegration Overview
Payment CheckoutCapture PaymentCancellations & Refunds
Inquiry
Error CodesBank CodesBank Maintenance Schedule
Cash Receipt
Before You BeginServers & NetworkIntegration Overview
Issue Cash ReceiptCancel Cash Receipt
Issuance Error LookupIssuance Status Lookup
Reprocessing RegistrationReprocessing Result Lookup
Reference
Firm Banking
Before You BeginIntegration Overview
Connection Management
Interbank TransferCollection TransferCollection Account SetupReserve Transfer (SC Bank)Trust Deposit (Woori Bank)
Transfer Failure WebhookTransaction Statement WebhookBill Statement WebhookBill Statement — Missing SequenceReserve Transfer Result Webhook (SC)Transfer Failure — Missing SequenceTransaction Detail — Missing Sequence
Account Holder Name LookupTransfer Result LookupBalance LookupReserve Transfer Result (SC)Auto Transfer Result (SC)
Transfer ReconciliationCollection ReconciliationWebhook Delivery Status
Connection Management
FX RemittanceCancel FX RemittanceFX Remittance Result WebhookFX Remittance Result — Missing SequenceFX Remittance (MX)FX Remittance Result Webhook (MX)FX Remittance — Missing Sequence (MX)
FX Same-Bank Holder LookupFX Account Holder LookupExchange Rate LookupExchange Rate Lookup (KEB)FX Remittance Result LookupFX Balance Lookup
FX Remittance ReconciliationFX Auto Transfer ReconciliationFX Same-Bank Remittance Reconciliation
FX Transaction Statement WebhookFX Transaction Statement — Missing Sequence
VAN Virtual Account
Getting Started with VAVSCommunication and Message FormatCommon Header
Recipient InquiryDeposit and Cancellation
RemittanceDeposit Balance Inquiry
Reconciliation
Account Holder InquiryActual Depositor NotificationActual Depositor FileMissing Actual Depositor InquiryWithdrawal Account Registration
Bank CodesResponse CodesChannel CodesBank Operating Hours
Prepaid Wallet
Before You BeginServers & NetworkIntegration Overview
Member Registration UIMy Account UI
Spend BalanceVoid SpendSend Money GiftRevoke Points
Balance LookupBalance OptionsBalance DetailsBalance by Top-upWithdrawable BalanceTransaction ListTransaction DetailsTransaction Details by StoreMember DetailsExpiring PointsTop-up Methods
Top-upCancel Top-upWithdraw FundsPending Withdrawal
Error CodesTransaction Type Codes

Tools

Encryption Test

JavaScript SDK Integration API

This document explains how to integrate the Checkout using the Hecto Financial JavaScript SDK (SettlePG).


Important Notes

Checkout Timeout

If 10 minutes elapse after entering the Checkout, a 'Transaction time has expired' error will occur. If the customer fails to complete the payment, the Checkout must be invoked again.

Loading the SDK Script

<!-- Sandbox environment -->
<script src="https://tbnpg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js"></script>

<!-- Production environment -->
<script src="https://npg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js"></script>

SETTLE_PG.pay()

SETTLE_PG.pay(options, callback);
ParameterTypeRequiredDescription
optionsObjectOPayment request parameters (see details below)
callbackFunction-Callback to receive results in iframe mode

Script Parameter Definitions

Parameters passed to the options object of SETTLE_PG.pay(). The SDK checks that env, ui, and the required parameters (mchtId, method, mchtTrdNo, trdDt, trdTm, trdAmt, mchtName, pmtPrdtNm, notiUrl, nextUrl, cancUrl, pktHash) are not empty and that the method value is valid; the remaining parameters are validated on the server.

Required Parameters

└envstring*Payment system environment URLhttps://tbnpg.settlebank.co.kr
Payment system environment URL
Sandbox: https://tbnpg.settlebank.co.kr Production: https://npg.settlebank.co.kr
Parameter
Type
Description
Example
envRequired
string
Payment system environment URL
Sandbox: https://tbnpg.settlebank.co.kr / Production: https://npg.settlebank.co.kr
https://tbnpg.settlebank.co.kr
└mchtIdstring*Merchant ID assigned by Hecto Financialnxca_jt_il
Merchant ID assigned by Hecto Financial
Parameter
Type
Description
Example
mchtIdRequired
string
Merchant ID assigned by Hecto Financial
nxca_jt_il
└methodstring*Payment method codecard
Payment method code
card: Credit Card bank: Bank Transfer vbank: Virtual Account vbank010: 010 Virtual Account mobile: Mobile Payment tmoney: T-money point: Point Damoa corp: Simple Payment teencash: Teencash culturecash: CultureCash smartcash: Smart Book Gift Card booknlife: Book Gift Card
*For any value not in this list, the SDK displays a 'method is wrong' error.
Parameter
Type
Description
Example
methodRequired
string
Payment method code
card: Credit Card / bank: Bank Transfer / vbank: Virtual Account / vbank010: 010 Virtual Account / mobile: Mobile Payment / tmoney: T-money / point: Point Damoa / corp: Simple Payment / teencash: Teencash / culturecash: CultureCash / smartcash: Smart Book Gift Card / booknlife: Book Gift Card
* For any value not in this list, the SDK displays a 'method is wrong' error.
card
└trdDtstring*Transaction date (YYYYMMDD format)20240101
Transaction date (YYYYMMDD format)
Parameter
Type
Description
Example
trdDtRequired
string
Transaction date (YYYYMMDD format)
20240101
└trdTmstring*Transaction time (HHMMSS format)153045
Transaction time (HHMMSS format)
Parameter
Type
Description
Example
trdTmRequired
string
Transaction time (HHMMSS format)
153045
└mchtTrdNostring*Merchant order number (unique, no duplicates)ORDER20240101153045
Merchant order number (unique, no duplicates)
Parameter
Type
Description
Example
mchtTrdNoRequired
string
Merchant order number (unique, no duplicates)
ORDER20240101153045
└trdAmtstring*Transaction amount (in KRW)10000
Transaction amount (in KRW)
Parameter
Type
Description
Example
trdAmtRequired
string
Transaction amount (in KRW)
10000
└notiUrlstring*Webhook URL for payment results (Server-to-Server)https://example.com/api/payment/noti
Webhook URL for payment results (Server-to-Server)
Parameter
Type
Description
Example
notiUrlRequired
string
Webhook URL for payment results (Server-to-Server)
https://example.com/api/payment/noti
└nextUrlstring*Redirect URL after payment completionhttps://example.com/payment/success
Redirect URL after payment completion
Parameter
Type
Description
Example
nextUrlRequired
string
Redirect URL after payment completion
https://example.com/payment/success
└pktHashstring*Request signature hash value (SHA-256)abc123...
Request signature hash value (SHA-256)
Parameter
Type
Description
Example
pktHashRequired
string
Request signature hash value (SHA-256)
abc123...
└mchtNamestring*Merchant name (Korean)Hecto Financial
Merchant name (Korean)
Parameter
Type
Description
Example
mchtNameRequired
string
Merchant name (Korean)
Hecto Financial
└pmtPrdtNmstring*Payment product nameLaptop Purchase
Payment product name
Parameter
Type
Description
Example
pmtPrdtNmRequired
string
Payment product name
Laptop Purchase
└cancUrlstring*Redirect URL on payment cancellationhttps://example.com/payment/cancel
Redirect URL on payment cancellation
Parameter
Type
Description
Example
cancUrlRequired
string
Redirect URL on payment cancellation
https://example.com/payment/cancel
└uiobject*UI configuration object (type, width, height){ type: "popup", width: 430, height: 660 }
UI configuration object (type, width, height)
Parameter
Type
Description
Example
uiRequired
object
UI configuration object (type, width, height)
{ type: "popup", width: 430, height: 660 }

Optional Parameters

└methodSubstringCredit card checkout sub-type. If omitted, the standard card checkout (/card/main.do) is called.auth
Credit card checkout sub-type. If omitted, the standard card checkout (/card/main.do) is called.
direct: Credit card direct call (/card/cardDirect.do) auth: Card registration (billing key issuance) checkout (/card/cardAuth.do)
*Use with method='card'. direct also requires cardGb (card company code); for auth request parameters, see the card registration (billing key issuance) checkout document.
Parameter
Type
Description
Example
methodSub
string
Credit card checkout sub-type. If omitted, the standard card checkout (/card/main.do) is called.
direct: Credit card direct call (/card/cardDirect.do) / auth: Card registration (billing key issuance) checkout (/card/cardAuth.do)
* Use with method='card'. direct also requires cardGb (card company code); for auth request parameters, see the card registration (billing key issuance) checkout document.
auth
└mchtENamestringMerchant name (English)Hecto Financial
Merchant name (English)
Parameter
Type
Description
Example
mchtEName
string
Merchant name (English)
Hecto Financial
└mchtCustNmstringCustomer nameHong Gil-dong
Customer name
Parameter
Type
Description
Example
mchtCustNm
string
Customer name
Hong Gil-dong
└custAcntSumrystringCustomer account summary informationShinhan 1234-56-7890
Customer account summary information
Parameter
Type
Description
Example
custAcntSumry
string
Customer account summary information
Shinhan 1234-56-7890
└mchtParamstringMerchant-specific parameter (passed through to notiUrl and nextUrl)name=Hong&age=25
Merchant-specific parameter (passed through to notiUrl and nextUrl)
Parameter
Type
Description
Example
mchtParam
string
Merchant-specific parameter (passed through to notiUrl and nextUrl)
name=Hong&age=25
└custIpstringCustomer IP address. Must be in IPv4 format (IPv6 not supported).127.0.0.1
Customer IP address. Must be in IPv4 format (IPv6 not supported).
Parameter
Type
Description
Example
custIp
string
Customer IP address. Must be in IPv4 format (IPv6 not supported).
127.0.0.1

ui Object Parameters

└ui.typestring*Checkout display modepopup
Checkout display mode
popup: Popup window iframe: Layer overlay self: Current window blank: New window
Parameter
Type
Description
Example
ui.typeRequired
string
Checkout display mode
popup: Popup window / iframe: Layer overlay / self: Current window / blank: New window
popup
└ui.widthstringPopup window width (px, used only with popup/iframe mode)430
Popup window width (px, used only with popup/iframe mode)
Parameter
Type
Description
Example
ui.width
string
Popup window width (px, used only with popup/iframe mode)
430
└ui.heightstringPopup window height (px, used only with popup/iframe mode)660
Popup window height (px, used only with popup/iframe mode)
Parameter
Type
Description
Example
ui.height
string
Popup window height (px, used only with popup/iframe mode)
660

UI Type Behavior

Specify the Checkout display mode using the SDK's ui.type option.

popup

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "popup", width: 430, height: 660 },
    // ... payment method-specific parameters
}, null);
  • Displays the Checkout in a separate popup window
  • Shows a guidance message if the popup is blocked
  • Redirects to nextUrl after payment completion

iframe (Layer) ⚠️

Avoid iframe method

The iframe method is not recommended due to issues such as local network access restrictions and browser compatibility problems. Use the popup, self, or blank method instead.
SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "iframe", width: 430, height: 660 },
    // ... payment method-specific parameters
}, function(response) {
    // Receive result
    if (response.outStatCd === "0021") {
        console.log("Success:", response.trdNo);
    } else {
        console.log("Failure:", response.outRsltMsg);
    }
});
  • Displays the Checkout as a dimmed layer overlay on the current page
  • Receives payment result via callback function (iframe only)
NOTE

iframe callback is for display purposes

The callback function is only invoked in iframe mode. In popup, self, and blank modes, the callback is not called and the user is redirected to nextUrl.

Callback Response Parameters

Key parameters of the response object passed to the callback function in iframe mode.

ParameterTypeDescription
outStatCdAN(4)Transaction status code (0021: Success, 0031: Failure, 0041: Pending, 0051: In Progress)
outRsltCdAN(4)Detailed result code
outRsltMsgAHN(200)Result message
trdNoAN(40)Hecto Financial transaction number
mchtTrdNoAN(100)Merchant order number
trdAmtN(12)Transaction amount
methodA(10)Payment method code

For additional parameters per payment method (card company name, virtual account number, etc.), refer to the Checkout Integration document.

NOTE

Order Processing Notice

Actual order processing (inventory deduction, status updates) must be performed at notiUrl. For details, refer to the Webhooks Integration Guide. Webhooks (notiUrl) Integration Guide

self (Current Window)

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "self" },
    // ... payment method-specific parameters
}, null);
  • Navigates to the payment page within the current window
  • Redirects to nextUrl after payment completion
  • Navigates to cancUrl when going back

blank (New Window)

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "blank" },
    // ... payment method-specific parameters
}, null);
  • Displays the Checkout in a new tab/window
  • Similar to popup but uses the browser's default new window behavior

Server-Side Processing

Before invoking the SDK, the backend must generate the transaction amount encryption (AES-256) and request signature hash (SHA-256).

Details: Before You Begin — Encryption and Request Signature (pktHash)


Error Handling

The SDK automatically detects errors and displays messages via browser alert. Below are examples of key error messages.

Popup Blocked

When a popup is blocked, the SDK automatically displays a guidance message.

Message from developers.hectofinancial.co.kr

[Hecto Financial] Popup blocking is enabled. Please disable it and try again.

How to unblock popups:

  • Chrome: Click the popup blocked icon on the right side of the address bar → 'Always allow'
  • Safari: Preferences → Websites → Pop-up Windows → 'Allow'
  • Edge: Settings → Cookies and site permissions → Pop-ups and redirects → Allow

Missing Required Parameters

The SDK displays an alert if env, ui, or any required parameter (mchtId, method, mchtTrdNo, trdDt, trdTm, trdAmt, mchtName, pmtPrdtNm, notiUrl, nextUrl, cancUrl, pktHash) is empty, or if the method value is invalid.

NOTE

Server-Side Validation

Detailed parameters per payment method (card number, expiry date, etc.) are validated on the server, not by the SDK. If server-side validation fails, an error message is displayed in the Checkout.
Message from developers.hectofinancial.co.kr

[Hecto Financial] Call parameter error (mchtId is null)


Payment Method-Specific Parameters

The SDK integration method is the same for all payment methods. Refer to the documents below for detailed parameters per payment method.

Details: Checkout Integration — Payment Method-Specific Parameters (Credit card, bank transfer, virtual account, mobile payment, and 16 other payment methods)

💬

Need technical support?

Code Samples

HectoFinancial GitHub