Foreign Currency Account Holder Inquiry (6000/450)
Used to inquire the account holder name for a domestic foreign currency account. Both same-bank and other-bank foreign currency accounts can be queried.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 6000 | 6100 |
| Business type | 450 | 450 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2000 bytes (Common Header 100 + Individual Data Block 1900) |
Bank-Specific Restrictions
For Woori Bank, the beneficiary information (Korean) returned on same-bank account holder inquiry is limited to a maximum of 12 bytes. Hana Bank does not validate the date of birth. Industrial Bank of Korea (IBK) is not supported.
NOTE
Woori Bank Residency Status Linkage
When using Woori Bank foreign currency remittance (2000/400) with remittance type 4 (KFTC), the resident/non-resident classification value returned by this message must be set in the request.
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 (450) |
| 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 | ID number (business registration) | 100 | X(13) | Y | - | |
| 2 | Customer number | 113 | X(10) | Y | - | Bank internal management number |
| 3 | Sender English name | 123 | X(35) | Y | - | |
| 4 | Beneficiary bank code | 158 | X(3) | Y | - | |
| 5 | Beneficiary account number | 161 | X(16) | Y | - | |
| 6 | Transaction currency | 177 | X(3) | Y | - | |
| 7 | Transaction amount | 180 | 9(15) | Y | - | Integer 12 digits, decimal 3 digits (12,3) |
| 8 | Beneficiary information (Korean) | 195 | X(44) | - | Y | |
| 9 | Beneficiary information (English) | 239 | X(42) | - | Y | |
| 10 | Paying bank branch code | 281 | X(7) | - | Y | |
| 11 | Transaction availability | 288 | X(1) | - | Y | |
| 12 | Resident/non-resident classification | 289 | X(2) | - | Y | First: sender residency, second: beneficiary residency. 1: Resident, 2: Non-resident |
| 13 | CMS account indicator | 291 | X(1) | - | Y | KEB (Korea Exchange Bank) only. Y: CMS account, N: Not a CMS account |
| 14 | Samsung Fire area | 292 | X(143) | - | - | KEB use |
| 15 | Reserved | 435 | X(1565) | - | - | SPACE |
NOTE
Transaction Currency Note
For Hana Bank, single-currency accounts (not multi-currency accounts ending in 38) do not validate the currency code.
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
ID number (business registration)13 · 100
Customer number10 · 113
Sender English name35 · 123
Beneficiary bank code3 · 158
Beneficiary account number16 · 161
Transaction currency3 · 177
Transaction amount15 · 180
Beneficiary information (Korean)44 · 195
Beneficiary information (English)42 · 239
Paying bank branch code7 · 281
Transaction availability1 · 288
Resident/non-resident classification2 · 289
CMS account indicator1 · 291
Samsung Fire area143 · 292
Reserved1565 · 435
필수
선택
응답전용 / 예비
길이 · 위치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