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

Cancellations & Refunds

This guide explains how to cancel payments and process refunds. The cancellation method and API differ by payment method.


Cancellation Types

TypeDescriptionSupported Payment Methods
Full CancellationCancel the full payment amountAll payment methods
Partial CancellationCancel only a portion of the amountCredit card, mobile payment, digital wallet, T-money, some gift cards
Virtual Account Issuance CancellationCancel virtual account before depositVirtual account
RefundRefund to customer's account after depositVirtual account, bank transfer, cash receipt

Cancellation Deadline Summary

Payment MethodCancellation DeadlinePartial CancellationNotes
Credit Card1 yearOSame day: approval cancellation, next day+: purchase cancellation
Virtual Account1 yearOBefore deposit: issuance cancellation, after deposit: Refund API
Bank Transfer180 daysXSame day: cancellation, next day+: refund
Mobile PaymentCurrent monthOFrom next month: Refund API
T-money90 daysO-
Gift Card1 year△Partial cancellation available for Teen Cash only
Point Damoa1 yearXFull cancellation then re-submit as a new payment
Digital Wallet1 yearOSame policy as credit card
Cash ReceiptCurrent yearXSame day: cancellation, next day+: refund

Partial Cancellation Availability

Partial cancellation availability varies by merchant configuration. If partial cancellation is needed, please request the configuration from your sales representative.

Cancellation Method by Payment Method

Credit Card

  • Cancellation Deadline: Within 1 year from the payment date
  • Same-Day Cancellation: Approval cancellation (immediate)
  • Next Day or Later: Purchase cancellation
  • Partial Cancellation: Supported (cancellation sequence number must be incremented sequentially)
Merchant
Hecto Financial
Card Company
1Cancellation API Request
Cancellation API Request
2Forward Cancellation Request
Forward Cancellation Request
3Cancellation Result
Cancellation Result
4Immediate Result Return
Immediate Result Return
NOTE

Partial Cancellation Notes

For partial cancellation, cnclOrd (cancellation sequence number) must be incremented sequentially starting from 001. Example: 1st partial cancellation (cnclOrd=001), 2nd partial cancellation (cnclOrd=002)

Virtual Account

For virtual accounts, the cancellation/refund method differs depending on the status.

StatusProcessing MethodAPI
Before DepositIssuance cancellationIssuance Cancellation API
After DepositRefund (wire transfer to customer's account)Refund API
Merchant
Hecto Financial
Customer
1Before Deposit: Issuance Cancellation API
Before Deposit: Issuance Cancellation API
2Issuance Cancellation Complete
Issuance Cancellation Complete
Merchant
Hecto Financial
Customer Account
1After Deposit: Refund API
After Deposit: Refund API
2Refund Registration Complete
Refund Registration Complete
3Next Business Day: Refund Transfer
Next Business Day: Refund Transfer

Virtual Account Refund Notes

Issuance cancellation is not possible for a virtual account after deposit has been completed. You must use the Refund API to refund to the customer's actual account.

Bank Transfer

  • Cancellation Deadline: Within 180 days
  • Same-Day Cancellation: Full cancellation only (real-time transfer to the withdrawal account)
  • Next Day or Later: Use Refund API (partial refund available)
  • Refund Account: The account used for payment or a separately designated account
NOTE

Bank Transfer Cancellation Special Notes

Only full cancellation is possible for same-day transactions. If partial cancellation is needed, use the Refund API from the next day.

Mobile Payment

  • Cancellation Method: Call the Cancellation API
  • Partial Cancellation: Supported
  • Cancellation Deadline: Until the last day of the payment month (use Refund API from the following month)

Mobile Payment Cannot Be Cancelled After the Payment Month

Mobile payment cannot be cancelled via API after the last day of the payment month. A refund from the following month requires a separate agreement with the carrier.

Gift Card

  • Cancellation Deadline: Within 1 year
  • Cancellation Method: Call the Cancellation API
  • Partial Cancellation: Varies by gift card type
Gift Card TypePartial Cancellation
Teen CashO
Culture CashX
Book Gift CardX
Smart MunhwaX
NOTE

Gift Cards Without Partial Cancellation Support

Culture Cash, Book Gift Card, and Smart Munhwa do not support partial cancellation. Process using full cancellation followed by re-submission as a new payment.

Point Damoa

  • Cancellation Deadline: Within 1 year
  • Cancellation Method: Call the Cancellation API
  • Partial Cancellation: Not supported (full cancellation then re-submit as a new payment)

T-money

  • Cancellation Deadline: Within 90 days
  • Cancellation Method: Call the Cancellation API
  • Partial Cancellation: Supported (cancellation sequence number must be incremented sequentially)

Digital Wallet (KakaoPay, NaverPay, TossPay, PAYCO)

  • Cancellation Deadline: Within 1 year
  • Same-Day Cancellation: Immediate cancellation
  • Next Day or Later: Purchase cancellation (takes 3-5 days)
  • Partial Cancellation: Supported (cancellation sequence number must be incremented sequentially)
NOTE

Digital Wallet Cancellation Policy

Digital wallet payments are processed internally as a credit card, so the same cancellation policy as credit card applies. However, partial cancellation is not available when payment was made with a gift (prepaid) card.

Cash Receipt

  • Cancellation Deadline: Within the current year
  • Same-Day Cancellation: Immediate cancellation
  • Next Day or Later: Refund processing
  • Partial Cancellation: Not supported

Cash Receipt Cancellation Deadline

Cash receipts can only be cancelled within the year of issuance. Be aware that cancellation is not possible once the year changes.

Conditions Where Partial Cancellation Is Not Possible

Partial cancellation is not possible under the following conditions.

ConditionPayment MethodAlternative
Below minimum amountAll payment methodsFull cancellation then re-submission as a new payment
Gift (prepaid) card paymentDigital walletFull cancellation then re-submission as a new payment
Culture Cash / Book Gift Card / Smart MunhwaGift cardFull cancellation then re-submission as a new payment
Same-day transactionBank transferRefund API from next day
Merchant configuration not appliedAll payment methodsRequest configuration from sales representative

Minimum Amount by Payment Method

Payment MethodMinimum Cancellation AmountMaximum Cancellation Amount
Credit Card100 KRWNegotiate with sales representative
Digital Wallet (Credit Card)100 KRWNegotiate with sales representative
Digital Wallet (Money/Points)More than 0 KRWNegotiate with sales representative
Cash ReceiptMore than 0 KRWNegotiate with sales representative
Virtual AccountMore than 0 KRW-
NOTE

Minimum Amount Warning

If the remaining amount after partial cancellation falls below the minimum amount, the partial cancellation may be declined.

Cancellation of Transactions Over 1 Year Old

The cancellation deadline for credit cards and digital wallet payments is 1 year, but you can directly cancel only within 1 year.

Elapsed PeriodCancellation Method
Within 1 yearCancel directly via API or admin page
Over 1 yearRequest to Hecto Financial representative

Cancellation of Transactions Over 1 Year

Transactions over 1 year old cannot be directly cancelled. If cancellation is needed, please contact your Hecto Financial representative.

Handling Cancellation Limit Exceeded

When cancellation is not possible due to insufficient settlement amount, automatic cancellation after reverse fund deposit can be processed.

Credit Card Reverse Cancellation Procedure

  1. Request cancellation from the merchant admin
  2. If settlement amount is insufficient, receive virtual account issuance guidance
  3. Deposit the reverse fund amount to the issued virtual account
  4. Automatic cancellation processed after deposit confirmation
NOTE

Reverse Cancellation Processing Time

Cancellation is automatically processed within approximately 5 minutes after deposit confirmation.

Cancellation Completion Timing

Cancellation API Response ≠ Actual Cancellation Complete

A successful response from the Cancellation API means the cancellation request has been accepted. There may be a delay before the actual cancellation processing is complete.
Payment MethodCancellation TypeActual Reflection Timing
Credit CardSame-day approval cancellationImmediate
Credit CardPartial / purchase cancellation3-5 days
Virtual AccountRefund3-5 days (next business day deposit)
Bank TransferSame-day cancellationImmediate (deposit to withdrawal account)
Digital WalletPurchase cancellation3-5 days

Cancellation Response Codes

outStatCdoutRsltCdDescription
00210000Cancellation successful
00310001System error
00310002Original transaction not found
00310003Cancellable amount exceeded
00310004Already cancelled transaction
NOTE

Handling Error Code 0003

Error 0003 means the merchant's settlement balance is insufficient to process this cancellation. Use the reverse fund deposit procedure described in the section below to resolve this.

Cancellation API by Payment Method

Cancellation/Refund API by Payment Method

💳

Credit Card Cancellation

Full cancellation / partial cancellation API

🏧

Virtual Account Issuance Cancellation

Issuance cancellation before deposit

🏧

Virtual Account Refund

Refund to customer account after deposit

🏦

Bank Transfer Cancellation

Bank transfer payment cancellation/refund

📱

Mobile Payment Cancellation

Mobile micropayment cancellation

🎁

Gift Card Cancellation

Gift card payment cancellation

🚇

T-money Cancellation

T-money payment cancellation

💰

Digital Wallet Cancellation

KakaoPay / NaverPay / TossPay / PAYCO

💬

Need technical support?

Code Samples

HectoFinancial GitHub