Balance Inquiry (7000/200)
Queries the current balance of the master account.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 7000 | 7100 |
| Business type | 200 | 200 |
| Direction | Merchant → Bank | Bank → Merchant |
NOTE
Queryable Accounts
Only accounts registered under the merchant code assigned by the bank can be queried.
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 (200) |
| 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 Body (200 bytes)
Request/Response Parameters
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Account number | 100 | 15 | Y | Master account |
| 2 | Overdraft limit | 115 | 13 | - | Overdraft limit (response) |
| 3 | Sign | 128 | 1 | - | SIGN symbol (+, -) (response) |
| 4 | Ledger balance | 129 | 13 | - | Ledger balance (response) |
| 5 | Cash/substitution amount | 142 | 13 | - | Cash/substitution amount (response) |
| 6 | Salary/cashier's check amount | 155 | 13 | - | Salary/cashier's check amount (response) |
| 7 | Other inter-bank (bills/checking) amount | 168 | 13 | - | Other inter-bank amount (response) |
| 8 | Sign | 181 | 1 | - | SIGN symbol (+, -) (response) |
| 9 | Actual available balance | 182 | 13 | - | Actual available balance for payment (response) |
| 10 | Reserved | 195 | 105 | - | SPACE |
Message Structure
Balance Inquiry Message (300 bytes)300 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 body200B · offset 100
Account number15 · 100
Overdraft limit13 · 115
Sign1 · 128
Ledger balance13 · 129
Cash/substitution amount13 · 142
Salary/cashier's check amount13 · 155
Other inter-bank (bills/checking) amount13 · 168
Sign1 · 181
Actual available balance13 · 182
Reserved105 · 195
필수
선택
응답전용 / 예비
길이 · 위치Response Parameters
| No | Field | Position | Length | Description |
|---|---|---|---|---|
| 2 | Overdraft limit | 115 | 13 | Overdraft limit |
| 3 | Sign | 128 | 1 | Ledger balance SIGN symbol (+, -) |
| 4 | Ledger balance | 129 | 13 | Ledger balance |
| 5 | Cash/substitution amount | 142 | 13 | Cash/substitution amount |
| 6 | Salary/cashier's check amount | 155 | 13 | Salary/cashier's check amount |
| 7 | Other inter-bank (bills/checking) amount | 168 | 13 | Other inter-bank amount |
| 8 | Sign | 181 | 1 | Actual available balance SIGN symbol (+, -) |
| 9 | Actual available balance | 182 | 13 | Actual available balance for payment |
Balance Types
| Type | Description |
|---|---|
| Ledger balance | Ledger balance of the account |
| Actual available balance | Amount actually available for payment (withdrawal) |
Check Actual Available Balance
When verifying the transferable amount, use the actual available balance, not the ledger balance.
Need technical support?
Code Samples
HectoFinancial GitHub