Withdrawal Account Registration (5080/5180)

This message validates and registers, modifies, or deregisters a customer withdrawal account linked to a virtual account.

Supported banks are BNK Kyongnam Bank, Hana Bank, Kbank, and Suhyup Bank. Registration and identity rules differ by bank.

Message Information

Item	Request	Response
Transaction type	`5080`	`5180`
Direction	Client institution → Bank	Bank → Client institution

Client Institution

Hecto Financial

Bank

11. Account registration (5080)

1. Account registration (5080)

22. Forward bank request

2. Forward bank request

33. Bank response (5180)

3. Bank response (5180)

44. Return registration result

4. Return registration result

Common Individual Body

No.	Field	MODE	Length	Offset	Request	Response	Description
1	Common header	-	70	0	●	⊙	Common Header
2	Bank institution code	AN	8	70	●	○	Code assigned by the bank
3	Account number	AN	16	78	●	○	Virtual account
4	Withdrawal account	AN	20	94	●	○	Customer withdrawal account
5	Start date	N	8	114	●	○	Fixed `00000000`
6	End date	N	8	122	●	○	Fixed `99999999`
7	Bank code	AN	3	130	●	○	Three-digit bank code of withdrawal account
8	Amount-check flag	AN	1	133	●	○	Fixed `N`
9	Amount	N	13	134	●	○	Fixed `0000000000000`
10	Registration action	AN	1	147	●	○	Bank-specific
11	Account-holder name	AN	20	148	●	○	Holder of withdrawal account
12	Customer type	AN	1	168	●	○	Individual, business, minor, or foreign national
13	Customer identity	AN	10	169	●	○	Bank- and customer-specific rule
14	Filler	AN	21	179	●	○	SPACE

Customer Types

Value	Type
`1`	Individual
`2`	Corporation
`3`	Minor
`4`	Foreign national

Bank-Specific Rules

Bank	Registration Action	Individual Identity	Corporate Identity	Notes
Kyongnam	`1` new, `3` deregister	First seven digits of resident ID	10-digit business number	Eight-character bank institution code
Hana	`1` new, `2` modify	First seven digits of resident ID	10-digit business number	The source does not define a deregistration action
Kbank	`1` new, `3` deregister	First seven digits of resident ID	10-digit business number	Up to five withdrawal accounts per virtual account
Suhyup	`1` new, `2` modify, `3` deregister	First seven resident-ID digits + one gender digit	10-digit business number	Use modify when registering again after deregistration

Suhyup Re-registration

After the initial registration, use 2 modify for any change.
After 3 deregistration, use 2 modify to register the account again.
On 0H15 already-registered error, continue with 2 modify.

Do Not Apply One Registration Rule to Every Bank

Although all banks use message 5080, action and identity rules differ. Select validation by bank code and reject unsupported actions before transmission.

Personal Data

Never record full account or identity numbers in logs.
Encrypt stored messages and apply access controls and retention limits.
Display only a masked suffix in error screens.
Avoid full raw-message exposure in operational tools.

Need technical support?

Code Samples

HectoFinancial GitHub