Foreign Currency Balance Inquiry (7000/900)
Used to inquire the balance of a foreign currency account.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 7000 | 7100 |
| Business type | 900 | 900 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2000 bytes (Common Header 100 + Individual Data Block 1900) |
NOTE
Hana Bank Single-Currency Accounts
For Hana Bank, single-currency accounts (not multi-currency accounts ending in 38) do not validate the currency code. For example, if a single-currency (JPY) account is queried with USD, the JPY balance is returned.
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: 7000, response: 7100) |
| 5 | Business type code | 28 | 3 | Y | Business type (900) |
| 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 | Withdrawal foreign currency account number | 100 | X(16) | Y | - | Account number pre-registered with the bank |
| 2 | Withdrawal foreign currency account currency | 116 | X(3) | - | Y | ISO CODE (e.g., USD, YEN) |
| 3 | Withdrawal foreign currency account balance | 119 | 9(15) | - | Y | Includes 3 decimal digits (12,3) |
| 4 | Reserved | 134 | X(1866) | - | - | 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
Withdrawal foreign currency account number16 · 100
Withdrawal foreign currency account currency3 · 116
Withdrawal foreign currency account balance15 · 119
Reserved1866 · 134
필수
선택
응답전용 / 예비
길이 · 위치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