헥토파이낸셜 개발자센터
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

Error Codes

Rejection codes returned by the White-Label service.

NOTE

Response Messages by Payment Method

The response message for the same response code may differ depending on the payment method (simple cash payment, PG). Refer to all response codes below.

White-Label-Specific Response Codes

Common

CodeDescriptionCodeDescription
0000Processed successfully0009User cancelled

Missing Payment Request Information (1001–1011)

CodeDescriptionCodeDescription
1001Missing payment request info (Merchant ID)1002Missing payment request info (request date)
1003Missing payment request info (request time)1004Missing payment request info (merchant order number)
1005Missing payment request info (transaction amount)1006Missing payment request info (result page URL)
1007Missing payment request info (payment cancel URL)1008Missing payment request info (merchant customer ID)
1009Missing payment request info (email)1010Missing payment request info (hash data)
1011Missing payment request info (product name)

Payment Request Information Length Error (1101–1122)

CodeDescriptionCodeDescription
1101Payment request length error (Merchant ID)1102Payment request length error (request date)
1103Payment request length error (request time)1104Payment request length error (merchant order number)
1105Payment request length error (transaction amount)1106Payment request length error (result page URL)
1107Payment request length error (payment cancel URL)1108Payment request length error (merchant customer ID)
1109Payment request length error (hash data)1110Payment request length error (merchant name)
1111Payment request length error (merchant reserved field)1112Payment request length error (email)
1113Payment request length error (tax exemption status)1114Payment request length error (taxable amount)
1115Payment request length error (VAT amount)1116Payment request length error (tax-free amount)
1117Payment request length error (service charge amount)1118Payment request length error (product name)
1119Payment request length error (bank statement descriptor)1120Payment request length error (resource circulation deposit)
1121Payment request length error (cash receipt additional deduction type)1122Payment request length error (CI verification flag)

Hash / Encryption Errors

CodeDescriptionCodeDescription
1901Hash value mismatch1902Encrypted field not processed

Customer / Authentication

CodeDescriptionCodeDescription
2005Password verification failed2010Customer service terminated

Token

CodeDescriptionCodeDescription
5001Token null5002Token expired
5003Token encoding error5004Token parse error
5005Token mapping error5006Token I/O error

Validation / Inquiry

CodeDescriptionCodeDescription
6001Invalid request message9002Payment checkout options inquiry error
9003Payment checkout banner inquiry error9004Terms list inquiry error
9005Notice inquiry error9006Partner discount inquiry error
9007Payment information inquiry error

Gateway / System

CodeDescriptionCodeDescription
9901Gateway request message error9902Gateway response message error
9903Gateway request error9904Gateway response error
9905Gateway system error9999Internal system error
9998Terminated user attempted access via invalid path

White-Label Specific

CodeDescription
WL01Authentication has been restricted for 15 minutes due to 10 or more attempts from the same IP within a set period. Please try again later.
WL02Customer information is invalid. Please verify the personal information used for identity verification.

Simple Cash Payment Response Codes

NOTE

Simple Cash Payment Response Codes

In addition to the ST codes below, the simple payment API may also return numeric codes in the format 10xxx (e.g., ST01 → 10001).
CodeDescriptionCodeDescription
0021Success0031Failure
ST01Account does not existST02Invalid account
ST03Duplicate withdrawalST04System error during VAN request
ST05No VAN responseST06Transaction reference not found
ST07Communication failureST08Account already registered
ST09Invalid request messageST10Internal system error
ST11Bank maintenance periodST12Insufficient funds in withdrawal account
ST13No ARS authentication resultST14ARS authentication request mismatch
ST15Automatic transfer account cancelledST16Withdrawal account transaction restricted
ST17Resident/business registration number errorST18Account error (cannot register for simple account)
ST19Other transaction not availableST20Account error
ST21Recipient account not foundST22Legally restricted account
ST23Non-real-name accountST24Account holder mismatch
ST25Transaction already voidedST26Void amount error
ST27ARS authentication failedST28ARS unreachable
ST29Account registration in progressST30Refund in progress
ST31Duplicate remittanceST32Payer name inquiry failed
ST33Single transaction limit exceededST34Daily transaction limit exceeded
ST35Suspended accountST36Connection timed out
ST37Simple payment voidedST38Request in progress
ST39Duplicate refund requestST40Request already in progress
ST41Service capacity exceededST42System busy
ST43Account already registeredST44Bank unavailable for transactions
ST50Duplicate message requestST51Cash receipt user already registered
ST52Cash receipt user not registeredST53Account already terminated
ST60Transaction failedST61Single transaction amount limit exceeded
ST62Daily amount limit exceededST63Monthly amount limit exceeded
ST64Daily transaction count limit exceededST65Monthly transaction count limit exceeded
ST66Password registration failedST67Password mismatch
ST68Service suspendedST69This payment service is unavailable due to policy restrictions
ST70This payment service is unavailable due to policy restrictions. Contact customer support (1600-5220).ST72ARS secondary authentication required for payment
ST86Authentication failed (mobile identity verification)ST87Simple identity verification not registered (mobile identity verification)
ST99Simple payment system under maintenanceVTIMIntermediary institution timeout
SE01Authentication validity period has expiredSE02Authentication code does not match
SE03Maximum authentication attempts exceeded

PG Common Response Codes

CodeDescriptionCodeDescription
ST01Customer information not foundSTR1–STR8Internal policy
ST03Already processed transactionST06Transaction information not found
ST07Invalid messageST08Account already registered
ST09Invalid request messageST10Internal system error
ST11Issuer maintenance periodST13Authentication record not found
ST19Other transaction not availableST24Account holder mismatch
ST25Duplicate void requestST26Void information error
ST30Authentication session expiredST32Account holder name error
ST38Processing in progressST39Duplicate refund request
ST41Traffic overloadST44Issuer information error
ST45Void failedST46Void period expired
ST47Merchant not registeredST48Merchant not registered
ST50Duplicate requestST54Partial void not available
ST55Mixed taxation amount mismatchST56Void sequence error
ST57Void amount exceeds original transaction amountST58Void request amount does not match original amount
ST60Abnormal processingST68Service suspended
ST69Service unavailableST70Policy blocked
ST79System errorST90–ST97Individually defined by payment method
ST99Other errorVTIMIssuer timeout
3007Void limit exceeded

Credit Card Response Codes

CodeDescriptionCodeDescription
CA01Issuer maintenanceCA02Issuer failure
CA03Message validation errorCA04Payment relay failure
CA10Transaction information not foundCA11Already captured transaction
CA12Already voided transactionCA13–CA19Request information error
CA20Card expiry date is invalidCA21–CA23Installment-related error
CA26Usage count exceededCA27–CA29Password-related error
CA30Identification number errorCA31–CA37Limit-related error
CA38Insufficient points balanceCA40–CA41Transaction amount error
CA42Transactions under KRW 1,000 or over KRW 99,999,999 are not allowedCA50–CA57Card status error
CA58Unregistered card. Please contact your card issuer.CA59Corporate cards cannot be used
CA60–CA64Merchant status errorCA65Merchant not contracted for authenticated transactions
CA70Identification number (date of birth/business number) + password invalidCA75Public certificate authentication information is invalid
CA80Transaction not availableCA81Error during transaction processing
CA82Please contact card issuerCA83This transaction cannot be voided
CA84Other error occurredCA85Error occurred during void processing
CA86Duplicate transactionCA87Merchant number is invalid
CA88Partial void is not available for this prepaid/gift card0905Identity verification required
J999Please contact card issuer8373Please contact card issuer
8375Other error
💬

Need technical support?

Code Samples

HectoFinancial GitHub