Deposit and Cancellation

These messages deliver a bank-originated virtual-account deposit or deposit cancellation to the client institution.

Transaction Codes

Type	Request	Response	Description
Deposit	`1000`	`1100`	Commonly a branch deposit
Deposit retry	`1001`	`1101`	Retries an unanswered `1000`
Transfer deposit	`3000`	`3100`	Deposit made by account transfer
Transfer deposit retry	`3001`	`3101`	Retries an unanswered `3000`
Deposit cancellation	`1010`	`1110`	Cancels a `1000`-series deposit
Transfer-deposit cancellation	`3010`	`3110`	Cancels a `3000`-series deposit
Missing deposit	`1003`	`1103`	Missing deposit record
Missing cancellation	`1013`	`1113`	Missing cancellation record

The distinction between 1000 and 3000 may vary by bank. Do not infer the customer's exact deposit channel from the transaction code alone.

Bank

Hecto Financial

Client Institution

11. Deposit request (1000/3000)

1. Deposit request (1000/3000)

22. Forward deposit request

2. Forward deposit request

33. Deposit response (1100/3100)

3. Deposit response (1100/3100)

44. Forward deposit response

4. Forward deposit response

Individual Body

No.	Field	MODE	Length	Offset	Request	Response	Description
1	Common header	-	70	0	●	○	Common Header
2	Account number	AN	16	70	●	○	Virtual account number
3	Account-holder name	AN	20	86	-	⊙	Virtual-account name; actual depositor name for some insurer integrations
4	Handling bank	AN	2	106	●	○	Two-digit bank code
5	Bank branch	AN	4	108	●	○	Handling branch
6	Amount	N	13	112	●	○	Deposit or cancellation amount
7	Depositor label	AN	20	125	●	○	Label entered by the depositor
8	Check amount	N	13	145	●	○	Check deposit amount
9	CMS_CD	AN	15	158	●	○	CMS identifier
10	Parent-account data	AN	14	173	●	○	Parent-account information from the bank
11	Bank code	AN	3	187	●	○	Three-digit financial institution code
12	Filler	AN	8	190	●	○	SPACE
13	Channel	AN	2	198	●	○	Channel Codes

For insurer integrations, Shinhan Bank and Hana Bank deposits may carry the actual depositor name in the account-holder name field.

Deposit Processing

Use the following unique key:

Transaction date (8) + Institution code (8) + Transaction number (7)

When the same unique key is received again, look up the original.
If already processed, do not apply the amount again; return a successful response.
If no original exists, process it as a new deposit.

SAF Retransmission

If the deposit response is not received, Hecto Financial may retry up to five times at five-minute intervals by default. An unresolved message may also be retransmitted on request, so idempotent processing is mandatory.

Cancellation Agency Method

When Hecto Financial handles recipient inquiry and deposit processing on your behalf, there are two methods based on who holds cancellation authority. Confirm which method applies to your institution when contracting.

Method	Cancellation handled by	Description
Receipt agency	Institution	Your institution decides the result of a cancellation request, and the cancellation is processed according to your response. (Automatic cancellation excluded.)
Transaction agency	Hecto Financial	Hecto Financial is delegated cancellation authority from your institution and processes it on your behalf.

NOTE

System cancellation is independent of the method

A system cancellation (common-header cancellation flag = A) is a notification of a cancellation already completed at the bank. Regardless of the receipt/transaction agency method, your institution must cancel the original deposit.

Customer Cancellation

A same-day correction at a bank branch or interbank network may initiate a cancellation.
Cancellations are generally available for branch deposits.
The bank's cancellation outcome depends on the client institution's response.
In SAF mode, a customer cancellation may also be delivered as a notification.
The cancellation carries the same transaction number as the original deposit.

The bank may treat 0000, V601 (original not found), and V607 (already cancelled) as a successful cancellation outcome. Check the local original state before choosing the response.

System Cancellation

A system cancellation can occur because of a bank processing error, a client response timeout, or another condition that requires the bank transaction to be reversed.

A System Cancellation Is Already Final at the Bank

When the common-header cancellation flag is A, the bank has already completed the cancellation. Reverse the original deposit regardless of whether your acknowledgement is delivered.

Banks that may initiate a system cancellation (as of July 24, 2026):

Code	Bank	Code	Bank
`003`	Industrial Bank of Korea (IBK)	`037`	Jeonbuk Bank
`020`	Woori Bank	`039`	BNK Kyongnam Bank
`023`	Standard Chartered Bank Korea	`071`	Korea Post
`027`	Citibank Korea	`088`	Shinhan Bank
`031`	iM Bank	`092`	Toss Bank
`032`	BNK Busan Bank
`035`	Jeju Bank

Delayed Deposit Delivery Option

This optional service holds a deposit for an agreed interval and delivers it only if no cancellation arrives during that interval.

Duplicate deposits to the same account for the same amount are rejected during the hold.
The option requires prior agreement with Hecto Financial.
A system cancellation received after the hold still must be processed by the client.

Response Codes

Code	Meaning
`0000`	Success
`V141`	Institution system or format error
`V142`	Institution not opened
`V151`	Opening institution outside service hours
`V309`	Duplicate transaction
`V413`	Other recipient restriction
`V416`	Already paid or payment count exceeded
`V601`	Original transaction not found
`V607`	Already cancelled
`V637`	Cancellation unavailable
`V682`	Deposit period mismatch
`V683`	Deposit period expired
`V713`	Invalid amount
`V783`	Opening institution busy or unavailable
`V785`	Other transaction unavailable
`V816`	Account not found
`V817`	Account error
`VTIM`	Timeout

Need technical support?

Code Samples

HectoFinancial GitHub