헥토파이낸셜 개발자센터
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 Request (2000/400)

Message for transferring foreign currency funds to an overseas or domestic foreign currency account. Only same-currency transfers are supported.


Message Information

ItemRequestResponse
Message code20002100
Business type400400
DirectionMerchant → BankBank → Merchant
Message size2000 bytes (Common Header 100 + Individual Data Block 1900)

Same-Currency Transfers Only

Foreign currency remittance requests are only supported for same-currency transfers. Example: USD→USD, JPY→JPY

Woori Bank Same-Bank Transaction Note

For Woori Bank, if no message response is received when the remittance type is 3 (Same-Bank transfer), you must confirm by phone with the bank or Hecto Financial.
NOTE

Confirming Remittance Result

For overseas remittance (1) and domestic remittance (2), the foreign currency remittance result notification (3000/700) must be confirmed as the final step. Same-Bank transfer (3) and KFTC-routed (4) transactions are completed upon the remittance 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: 2000, response: 2100)
5Business type code283YBusiness type (400)
6Transmission count311YFixed value '1'
7Message sequence number326YDaily unique sequence number (MAX 950,000)
8Transmission date388YMessage transmission 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 Parameters

NoFieldPositionLengthRequiredDescription
1Customer number1009(10)YBusiness registration number
2Debit account number110X(16)YAccount number pre-registered with the bank
3Recall code126X(6)YUsed after agreement with the bank
4Remittance amount1329(15)YIncludes 3 decimal places (12,3)
5Remittance currency147X(3)YISO CODE (e.g., USD, JPY)
6Remittance type150X(1)Y1: Overseas remittance, 2: Domestic remittance, 3: Same-Bank transfer, 4: Domestic remittance (KFTC-routed), P: Position transaction (SC Bank)
7Remitter name (English)151X(35)YSender
8Beneficiary name (English)186X(35)YRecipient
9Beneficiary account number221X(35)YAt least one of beneficiary account number or address is required
10Beneficiary address256X(3*35)YAt least one of beneficiary account number or address is required
11Instructions to beneficiary361X(4*35)N
12Counterpart country code501X(2)Y
13Remittance to sanctioned country503X(1)NSet 'Y' when remitting to a sanctioned country
14Beneficiary bank code504X(11)YBIC CODE / Same-Bank DORRES CODE
15Beneficiary bank name and address515X(4*35)NMay be omitted if bank code is entered
16Intermediary bank 1655X(2*35)NUsed when specifically designated
17Intermediary bank 2725X(2*35)N
18Intermediary bank 3795X(2*35)N
19Fee debit account number865X(16)Y
20Overseas bank fee bearer881X(1)Y1: Remitter bears, 2: Beneficiary bears, 3: Both bear (Hana/IBK exclusive)
21Overseas bank fee debit account designation882X(1)Y1: Debit account, 2: Fee debit account
22Payment purpose code8839(3)NChoose one: payment purpose code or payment purpose (Korean)
23Payment purpose886X(35)NChoose one: payment purpose code or payment purpose (Korean)
24Price terms921X(3)NRequired for deferred payment remittances exceeding USD 1,000
25H.S CODE9249(10)N
26Import declaration number934X(22)N
27Import purpose956X(1)N
28Memo957X(14)NSet when remittance type is 3 (Same-Bank transfer)
29Beneficiary account holder name971X(22)-Set in response
30Debit account balance9939(15)-Set in response
31Beneficiary email address 11008X(50)NUp to 5 recipients can be notified per remittance
32Beneficiary email address 21058X(50)N
33Beneficiary email address 31108X(50)N
34Beneficiary email address 41158X(50)N
35Beneficiary email address 51208X(50)N

Bank-Specific Additional Fields

The following fields are only used by specific banks or specific remittance types.

NoFieldPositionLengthConditionDescription
36Non-trade post-management number1258X(16)ConditionalIssued by branch. Based on trade/non-trade, business entity, reason, and currency code
37Spare field1274X(4)Conditional
38Bank code1278X(3)Remittance type 4Added for KFTC-routed transactions
39Beneficiary branch giro code1281X(7)Remittance type 4Added for KFTC-routed transactions
40Residence classification1288X(2)Remittance type 4First: remitter residence, Second: beneficiary residence (Resident: 1, Non-resident: 2). Woori Bank: set with 6000/450 result value; Hana Bank: only 11 or 22 allowed
41Account holder inquiry sequence number12909(6)Remittance type 4, required for Woori Bank
42Foreign exchange bank designation code1296X(2)Woori Bank
43Foreign exchange bank designation resident ID or passport number1298X(13)Woori Bank
44Financial currency code13119(3)Woori Bank
45Media classification1314X(2)Woori Bank
46Settlement bank fee1316X(18)Woori Bank
47Payment purpose code13349(5)Required for remittance types 1, 2
48Scheduled date13399(8)IBK
49Debit amount (KRW equivalent)13479(15)SC Bank
50Applied exchange rate13629(1)SC Bank1: system rate, 2: contracted rate
51Handling fee bearer classification13639(1)SC Bank1: Remitter bears, 2: Beneficiary bears
52Reserved1364X(636)-SPACE

Notes by Remittance Type

Fields Used for Same-Bank Foreign Currency Account Transfer (Remittance Type: 3)

  1. Debit account number: Debit foreign currency account number
  2. Recall code
  3. Remittance amount
  4. Remittance currency
  5. Remittance type: 3 (Same-Bank transfer)
  6. Fee debit account number: Credit foreign currency account number
  7. Memo: Notes to the counterparty such as credit reason
  8. Beneficiary account holder name
  9. Debit foreign currency account balance

Bank-Specific Notes

For IBK, when remittance type is domestic (2), the payment purpose code must be set to 10001. Standard Chartered Bank Korea does not support KFTC-routed domestic remittance (remittance type 4).

Message Structure

Request 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
Customer number10 · 100
Debit account number16 · 110
Recall code6 · 126
Remittance amount15 · 132
Remittance currency3 · 147
Remittance type1 · 150
Remitter name (English)35 · 151
Beneficiary name (English)35 · 186
Beneficiary account number35 · 221
Beneficiary address105 · 256
Instructions to beneficiary140 · 361
Counterpart country code2 · 501
Remittance to sanctioned country1 · 503
Beneficiary bank code11 · 504
Beneficiary bank name and address140 · 515
Intermediary bank 170 · 655
Intermediary bank 270 · 725
Intermediary bank 370 · 795
Fee debit account number16 · 865
Overseas bank fee bearer1 · 881
Overseas bank fee debit account designation1 · 882
Payment purpose code3 · 883
Payment purpose35 · 886
Price terms3 · 921
H.S CODE10 · 924
Import declaration number22 · 934
Import purpose1 · 956
Memo14 · 957
Beneficiary account holder name22 · 971
Debit account balance15 · 993
Beneficiary email address 150 · 1008
Beneficiary email address 250 · 1058
Beneficiary email address 350 · 1108
Beneficiary email address 450 · 1158
Beneficiary email address 550 · 1208
Non-trade post-management number16 · 1258
Spare field4 · 1274
Bank code3 · 1278
Beneficiary branch giro code7 · 1281
Residence classification2 · 1288
Account holder inquiry sequence number6 · 1290
Foreign exchange bank designation code2 · 1296
Foreign exchange bank designation resident ID or passport number13 · 1298
Financial currency code3 · 1311
Media classification2 · 1314
Settlement bank fee18 · 1316
Payment purpose code5 · 1334
Scheduled date8 · 1339
Debit amount (KRW equivalent)15 · 1347
Applied exchange rate1 · 1362
Handling fee bearer classification1 · 1363
Reserved636 · 1364
필수
선택
응답전용 / 예비
길이 · 위치

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.)

VTIM Response

The VTIM response code indicates a response timeout. This is a session error, not an error response. If the foreign currency remittance result notification (3000/700) is not received, verify using 3000/800 (missing sequence inquiry).
💬

Need technical support?

Code Samples

HectoFinancial GitHub