Deposit Transaction Detail Notification (4000/100)
Sent in real time from the bank to the merchant when a deposit or withdrawal occurs in the master account.
Message Information
| Item | Notification | Response |
|---|---|---|
| Message code | 4000 | 4100 |
| Business type | 100 | 100 |
| Direction | Bank → Merchant | Merchant → Bank |
NOTE
Real-Time Deposit Confirmation
This message allows real-time receipt of deposit activity in the master account. It can be used for deposit confirmation services.
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 (notification: 4000, response: 4100) |
| 5 | Business type code | 28 | 3 | Y | Business type (100) |
| 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)
Notification Parameters (Bank → Merchant)
| No | Field | Position | Length | Description |
|---|---|---|---|---|
| 1 | Transaction account number | 100 | 15 | Account number where the transaction occurred |
| 2 | Branch GIRO code | 115 | 7 | Branch GIRO code |
| 3 | Deposit/withdrawal/cancellation type | 122 | 2 | 11: Deposit, 21: Withdrawal, 31: Deposit cancellation, 32: Withdrawal cancellation, 99: Other |
| 4 | Transaction type | 124 | 2 | Refer to transaction detail notification type code table |
| 5 | Transaction amount | 126 | 13 | Transaction amount |
| 6 | Cash | 139 | 13 | Available withdrawal amount for today |
| 7 | Bills/inter-bank items | 152 | 13 | Available withdrawal amount for next day |
| 8 | Post-transaction balance sign | 165 | 1 | SIGN symbol (+, -) |
| 9 | Post-transaction balance | 166 | 13 | Balance after transaction |
| 10 | Depositor/withdrawer name | 179 | 12 | Depositor or withdrawer name |
| 11 | Check number | 191 | 10 | Bill or check number |
| 12 | Transaction date | 201 | 8 | Transaction date (YYYYMMDD) |
| 13 | Transaction time | 209 | 6 | Transaction time (hhmmss) |
| 14 | Transaction sequence number | 215 | 6 | Transaction sequence number |
| 15 | Original transaction sequence number on cancellation | 221 | 6 | Set only on cancellation |
| 16 | Original transaction date | 227 | 8 | Set only on cancellation |
| 17 | CMS code/real-name number | 235 | 16 | CMS code or real-name number |
| 18 | Cashier's check amount | 251 | 13 | Cashier's check amount |
| 19 | Personal check amount | 264 | 13 | Personal check amount |
| 20 | Depositor/withdrawer name | 277 | 20 | SC Bank only (20 bytes) |
| 21 | Transaction amount type code | 297 | 2 | SC Bank only |
| 22 | Reserved area | 299 | 1 | SPACE |
Message Structure
Deposit Transaction Detail Notification 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
Transaction account number15 · 100
Branch GIRO code7 · 115
Deposit/withdrawal/cancellation type2 · 122
Transaction type2 · 124
Transaction amount13 · 126
Cash13 · 139
Bills/inter-bank items13 · 152
Post-transaction balance sign1 · 165
Post-transaction balance13 · 166
Depositor/withdrawer name12 · 179
Check number10 · 191
Transaction date8 · 201
Transaction time6 · 209
Transaction sequence number6 · 215
Original transaction sequence number on cancellation6 · 221
Original transaction date8 · 227
CMS code/real-name number16 · 235
Cashier's check amount13 · 251
Personal check amount13 · 264
Depositor/withdrawer name20 · 277
Transaction amount type code2 · 297
Reserved area1 · 299
필수
선택
응답전용 / 예비
길이 · 위치Response Parameters (Merchant → Bank)
The response message (4100/100) must be sent after receiving the notification.
| No | Field | Position | Length | Description |
|---|---|---|---|---|
| 1-22 | (Same) | - | - | Return the received content as-is |
Response Required
The notification message including the reserved area must be returned as-is in the response.
Use Cases
Real-Time Deposit Confirmation
| Step | Stage | Processing | Message | Notes |
|---|---|---|---|---|
| 1 | Customer → Bank | Deposit to master account | - | - |
| 2 | Bank → Merchant | Transaction detail notification | 4000/100 | Deposit/withdrawal type: 11 (deposit), includes transaction amount and depositor info |
| 3 | Merchant → Bank | Send response | 4100/100 | Return received content as-is |
| 4 | Merchant | Process deposit record | - | Order confirmation, point charging, etc. |
Transaction Sequence Number Management
- Transaction sequence numbers are assigned sequentially by day. Some banks assign them sequentially by account and date.
- If a missing sequence occurs, the missing record can be queried using the 4000/200 message.
Need technical support?
Code Samples
HectoFinancial GitHub