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

Foreign Currency Remittance Result Notification Missing Sequence (3000/800)

Message for querying missing (skipped) sequence numbers in the foreign currency remittance result notification (3000/700). Set the retransmission target sequence number in the Common Header message sequence number field, and the retransmission target transaction date in the transmission date field.


Message Information

ItemRequestResponse
Message code30003100
Business type800800
DirectionMerchant → BankBank → Merchant
Message size2000 bytes (Common Header 100 + Individual Data Block 1900)
NOTE

Common Header Setup Note

For missing sequence inquiry, set the retransmission target sequence number in the Common Header message sequence number field, and the retransmission target transaction date (YYYYMMDD) in the transmission date field.

IBK / Standard Chartered Bank Korea Notes

For IBK and Standard Chartered Bank Korea, set the missing sequence number in the Common Header message sequence number field and today's transmission date in the transmission date field. Set the remittance request date in the foreign currency remittance request date field. Standard Chartered Bank Korea receives the result as a result notification (3000/700) message instead of a direct response.

Common Header (100 bytes)

This is the common header for all Real-Time Firm Banking messages.

NoFieldPositionLengthRequiredDescription
1Identification code09YRecipient's TRANSACTION CODE (SETTLEBNK or SPACE)
2Merchant ID912YMerchant ID assigned by Hecto Financial
3Bank code213YOpening bank code contracted for firm banking
4Message type code244YMessage code (request: 3000, response: 3100)
5Business type code283YBusiness type (800)
6Transmission count311YFixed value '1'
7Message sequence number326YRetransmission target sequence number
8Transmission date388YRetransmission target transaction date (YYYYMMDD)
9Transmission time466YMessage transmission time (hhmmss)
10Response code524-Response code (error code), SPACE on request
11Reserved area5644-Hecto Financial proprietary area

Individual Data Block (1900 bytes)

Request/Response Parameters

NoFieldPositionLengthRequestResponseDescription
1Foreign currency remittance request date1009(8)YYForeign currency remittance request acceptance date
2Foreign currency remittance request sequence number1089(6)ConditionalYForeign currency remittance request message sequence number
3Customer number1149(10)-YBusiness registration number
4Debit account number124X(16)-YAccount number pre-registered with the bank
5Remittance amount1409(15)-YIncludes 3 decimal places (12,3)
6Remittance currency155X(3)-YISO CODE (e.g., USD, JPY)
7Remittance type158X(1)-Y1: Overseas remittance, 2: Domestic remittance, 3: Same-Bank transfer, 4: Domestic remittance (KFTC-routed)
8Remitter name (English)159X(35)-YSender
9Beneficiary name (English)194X(35)-YRecipient
10Beneficiary account number229X(35)-Y
11Beneficiary address264X(3*35)-Y
12Instructions to beneficiary369X(4*35)-Y
13Counterpart country code509X(2)-Y
14Remittance to sanctioned country511X(1)-NSet 'Y' when remitting to a sanctioned country
15Beneficiary bank code512X(11)-YBIC CODE / Same-Bank DORRES CODE
16Beneficiary bank name and address523X(4*35)-NMay be omitted if bank code is entered
17Remittance message type663X(1)-Y1: MT100, 2: MT100 & MT202
18Settlement bank code664X(11)-YSettlement bank BIC CODE
19Settlement bank675X(35)-YSettlement bank name
20Intermediary bank 1 code710X(11)-NBIC CODE
21Intermediary bank 1721X(35)-NIntermediary bank 1 name
22Intermediary bank 2 code756X(11)-NBIC CODE
23Intermediary bank 27679(35)-NIntermediary bank 2 name
24Intermediary bank 3 code802X(11)-NBIC CODE
25Intermediary bank 3813X(35)-NIntermediary bank 3 name
26Fee debit account number8489(16)-Y
27Overseas bank fee bearer864X(1)-Y1: Beneficiary bears, 2: Remitter bears
28Overseas bank fee debit account designation865X(1)-Y1: Debit account, 2: Fee debit account
29Remittance amount (debit account currency basis)8669(15)-YIncludes 3 decimal places
30Exchange rate applied on debit8819(7)-YApplied when debiting KRW account (includes 2 decimal places)
31Domestic remittance fee8889(15)-YIncludes 3 decimal places
32Exchange rate applied on domestic fee debit9039(7)-YApplied when debiting KRW account (includes 2 decimal places)
33Overseas bank payment fee9109(15)-YFee incurred by settlement bank (includes 3 decimal places)
34Exchange rate applied on overseas bank fee debit9259(7)-YApplied when debiting KRW account (includes 2 decimal places)
35Payment purpose code9329(3)-NChoose one: payment purpose code or payment purpose (Korean)
36Payment purpose935X(35)-NChoose one: payment purpose code or payment purpose (Korean)
37Transaction number9709(20)-Y
38ValueDate990X(8)-N

Bank-Specific Additional Fields

NoFieldPositionLengthConditionDescription
39Foreign exchange bank designation code998X(2)Woori Bank
40Foreign exchange bank designation resident ID or passport number1000X(13)Woori Bank
41Financial currency code10139(3)Woori Bank
42Financial exchange rate10169(11)Woori BankIncludes 5 decimal places
43Payment purpose code10279(5)YBank of Korea payment purpose code digit change (2014.12.15)
44Debit amount (KRW equivalent)10329(15)SC Bank
45Reserved1047X(953)-SPACE

Message Structure

Request/Response Message (2000 bytes)2000 bytes
Common Header100B · offset 0
Identification code9 · 0
Merchant ID12 · 9
Bank code3 · 21
Message type code4 · 24
Business type code3 · 28
Transmission count1 · 31
Message sequence number6 · 32
Transmission date8 · 38
Transmission time6 · 46
Response code4 · 52
Reserved area44 · 56
Individual Data Block1900B · offset 100
Foreign currency remittance request date8 · 100
Foreign currency remittance request sequence number6 · 108
Customer number10 · 114
Debit account number16 · 124
Remittance amount15 · 140
Remittance currency3 · 155
Remittance type1 · 158
Remitter name (English)35 · 159
Beneficiary name (English)35 · 194
Beneficiary account number35 · 229
Beneficiary address105 · 264
Instructions to beneficiary140 · 369
Counterpart country code2 · 509
Remittance to sanctioned country1 · 511
Beneficiary bank code11 · 512
Beneficiary bank name and address140 · 523
Remittance message type1 · 663
Settlement bank code11 · 664
Settlement bank35 · 675
Intermediary bank 1 code11 · 710
Intermediary bank 135 · 721
Intermediary bank 2 code11 · 756
Intermediary bank 235 · 767
Intermediary bank 3 code11 · 802
Intermediary bank 335 · 813
Fee debit account number16 · 848
Overseas bank fee bearer1 · 864
Overseas bank fee debit account designation1 · 865
Remittance amount (debit account currency basis)15 · 866
Exchange rate applied on debit7 · 881
Domestic remittance fee15 · 888
Exchange rate applied on domestic fee debit7 · 903
Overseas bank payment fee15 · 910
Exchange rate applied on overseas bank fee debit7 · 925
Payment purpose code3 · 932
Payment purpose35 · 935
Transaction number20 · 970
ValueDate8 · 990
Foreign exchange bank designation code2 · 998
Foreign exchange bank designation resident ID or passport number13 · 1000
Financial currency code3 · 1013
Financial exchange rate11 · 1016
Payment purpose code5 · 1027
Debit amount (KRW equivalent)15 · 1032
Reserved953 · 1047
필수
선택
응답전용 / 예비
길이 · 위치

Response Codes

Response codes vary by bank. You can request the code list from the bank or Hecto Financial.

  • The response code field in the Common Header is set to SPACE in request messages and to the applicable error code in response messages.
  • The VTIM response code indicates a response timeout session error and is not an error response. (If 3000/700 is not received, verify using 3000/800.)
💬

Need technical support?

Code Samples

HectoFinancial GitHub