헥토파이낸셜 개발자센터

Account Holder Inquiry (2001/2101)

Use this optional message to verify a destination account and retrieve its holder name before remittance.

Message Information

ItemRequestResponse
Transaction type20012101
DirectionClient institution → BankBank → Client institution
Required before remittanceNo-
Client Institution
Hecto Financial
Bank
11. Holder-name inquiry (2001)
22. Forward inquiry
33. Inquiry response (2101)
44. Return holder name

Common-Header Request Values

FieldValue
Direction3
Transaction numberSPACE or 0000000; populated in response
User transaction numberDaily unique number generated by the client
OriginO
Delivery modeY

Individual Body

No.FieldMODELengthOffsetRequestResponseDescription
1Common header-700●○Common Header
2Account numberAN1670●○Account to query
3Account-holder nameAN2086-⊙Name returned by the bank
4Handling bankAN2106●○Target two-digit bank code
5Bank branchAN4108●○SPACE if unknown
6AmountN13112●○Fixed 0000000000100
7Requester nameAN20125●○Korean or digits recommended
8Check amountN13145●○SPACE or 0000000000000
9CMS_CDAN15158●○SPACE if unused
10FillerAN14173●○SPACE
11Bank codeAN3187●○Target three-digit bank code
12FillerAN8190●○SPACE
13ChannelAN2198●○Channel code when applicable

Processing Rules

  • The user transaction number must be unique for the day.
  • Some banks do not support English requester names; Korean or digits are recommended.
  • Decode the holder name using EUC-KR and remove trailing SPACE only.
  • Enforce the 20-byte maximum after encoding.
NOTE

An Inquiry Does Not Guarantee Remittance Success

The account state or bank operating status can change after the inquiry. Use the 6010/6110 remittance response as the final result.
💬

Need technical support?