Foreign Currency Account Holder Inquiry — Same Bank (6000/401)
Used to inquire the account holder name for a same-bank domestic foreign currency account. Available for Hana Bank (081) only.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 6000 | 6100 |
| Business type | 401 | 401 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2000 bytes (Common Header 100 + Individual Data Block 1900) |
NOTE
Hana Bank Exclusive
This message is available for Hana Bank (081) only. For Hana Bank, the transaction currency is not validated.
Common Header (100 bytes)
This is the common header for all Real-Time Firm Banking messages.
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Identification code | 0 | 9 | Y | Recipient's TRANSACTION CODE (SETTLEBNK or SPACE) |
| 2 | Merchant ID | 9 | 12 | Y | Merchant ID assigned by Hecto Financial |
| 3 | Bank code | 21 | 3 | Y | Opening bank code contracted for firm banking |
| 4 | Message type code | 24 | 4 | Y | Message code (request: 6000, response: 6100) |
| 5 | Business type code | 28 | 3 | Y | Business type (401) |
| 6 | Transmission count | 31 | 1 | Y | Fixed value '1' |
| 7 | Message sequence number | 32 | 6 | Y | Daily unique sequence number (MAX 950,000) |
| 8 | Transmission date | 38 | 8 | Y | Message transmission date (YYYYMMDD) |
| 9 | Transmission time | 46 | 6 | Y | Message transmission time (hhmmss) |
| 10 | Response code | 52 | 4 | - | Response code (error code), SPACE on request |
| 11 | Reserved area | 56 | 44 | - | Hecto Financial proprietary area |
Individual Data Block (1900 bytes)
Request/Response Parameters
| No | Field | Position | Length | Request | Response | Description |
|---|---|---|---|---|---|---|
| 1 | Beneficiary account number | 100 | X(15) | Y | Y | Foreign currency account number |
| 2 | ID number (business registration) | 115 | X(13) | Y | Y | Bank internal management number |
| 3 | Beneficiary information (Korean) | 128 | X(12) | Y | - | |
| 4 | Beneficiary bank code | 140 | X(3) | Y | Y | |
| 5 | Transaction currency | 143 | X(3) | Y | Y | |
| 6 | Reserved | 146 | X(1854) | - | - | SPACE |
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
Beneficiary account number15 · 100
ID number (business registration)13 · 115
Beneficiary information (Korean)12 · 128
Beneficiary bank code3 · 140
Transaction currency3 · 143
Reserved1854 · 146
필수
선택
응답전용 / 예비
길이 · 위치Response Codes
Response codes vary by bank. The full code list can be requested from the relevant bank or Hecto Financial.
- The response code field in the Common Header must be set to SPACE in request messages; the bank sets the appropriate error code in response messages.
- The response code VTIM indicates a session timeout (not an error response). If 3000/700 is not received, verify using 3000/800.
Need technical support?
Code Samples
HectoFinancial GitHub