Bill Statement Notification (4000/500)
Notified in real time to the merchant when a consigned bill transaction occurs, such as registration, collection, or return.
Message Information
Bill Statement Notification
| Item | Notification | Response |
|---|---|---|
| Message code | 4000 | 4100 |
| Business type | 500 | 500 |
| Direction | Bank → Merchant | Merchant → Bank |
| Message size | 300 bytes (Common header 100 + Individual body 200) |
NOTE
Reserved Area Processing
On bill statement notification, the reserved area must be returned as-is from the original message.
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/request: 4000, response: 4100) |
| 5 | Business type code | 28 | 3 | Y | Business type (500) |
| 6 | Transmission count | 31 | 1 | Y | Fixed value '1' |
| 7 | Message sequence number | 32 | 6 | Y | Daily unique sequence number |
| 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 | - | Return as-is from original message on notification |
Individual Body (200 bytes)
Notification/Response Parameters
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Transaction type code | 100 | X(2) | Y | Refer to transaction type code table |
| 2 | Account number | 102 | X(15) | Y | |
| 3 | Transaction date | 117 | 9(8) | Y | YYYYMMDD |
| 4 | Transaction time | 125 | 9(6) | Y | hhmmss |
| 5 | Transaction sequence number | 131 | 9(5) | Y | |
| 6 | Bill number | 136 | X(10) | Y | |
| 7 | Bill type | 146 | 9(2) | Y | Refer to bill type code table |
| 8 | Bill amount | 148 | 9(13) | Y | |
| 9 | Issuer | 161 | X(12) | Y | |
| 10 | Bill maturity date | 173 | 9(8) | Y | YYYYMMDD |
| 11 | Consignment branch code | 181 | X(7) | Y | Consignment transaction branch code |
| 12 | Payment bank code | 188 | 9(3) | Y | |
| 13 | Payment bank name | 191 | X(4) | Y | |
| 14 | Payment branch name | 195 | X(10) | Y | |
| 15 | Collection type | 205 | X(1) | Y | 1: Exchange, 2: Collection, 3: Same branch |
| 16 | Depositor code | 206 | X(16) | Y | Business registration number or resident registration number |
| 17 | Post-transaction balance | 222 | 9(14) | Y | |
| 18 | Own/third-party type | 236 | X(1) | Y | 1: Own, 9: Third-party |
| 19 | Original transaction date on cancellation | 237 | 9(8) | Conditional | Set only on cancellation |
| 20 | Original transaction number on cancellation | 245 | 9(6) | Conditional | Set only on cancellation |
| 21 | Bill number (Woori) | 251 | X(20) | - | Woori Bank use |
| 22 | Endorser | 271 | X(15) | - | Woori Bank use |
| 23 | Business registration number | 286 | X(10) | - | Woori Bank use |
| 24 | Bill type (Woori) | 296 | X(2) | - | Woori Bank use (30: Electronic bill) |
| 25 | Reserved | 298 | X(2) | - | SPACE |
Transaction Type Code Table
| Code | Description |
|---|---|
| 10 | Consignment registration |
| 15 | Consignment registration cancellation |
| 20 | Collection |
| 25 | Collection cancellation |
| 30 | Return |
| 40 | Item change |
| 50 | Dishonor registration |
Bill Type Code Table
| Code | Description |
|---|---|
| 01 | Bill of exchange |
| 02 | Promissory note |
| 03 | Checking account check (domestic) |
| 04 | Checking account check (foreign) |
| 05 | Personal check (KRW 1,000,000) |
| 06 | Personal check (KRW 5,000,000) |
| 07 | Cashier's check |
| 08 | Post office |
| 99 | Other |
Message Structure
Bill Statement 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 type code2 · 100
Account number15 · 102
Transaction date8 · 117
Transaction time6 · 125
Transaction sequence number5 · 131
Bill number10 · 136
Bill type2 · 146
Bill amount13 · 148
Issuer12 · 161
Bill maturity date8 · 173
Consignment branch code7 · 181
Payment bank code3 · 188
Payment bank name4 · 191
Payment branch name10 · 195
Collection type1 · 205
Depositor code16 · 206
Post-transaction balance14 · 222
Own/third-party type1 · 236
Original transaction date on cancellation8 · 237
Original transaction number on cancellation6 · 245
Bill number (Woori)20 · 251
Endorser15 · 271
Business registration number10 · 286
Bill type (Woori)2 · 296
Reserved2 · 298
필수
선택
응답전용 / 예비
길이 · 위치Response Codes
Response codes vary by bank. The code list can be requested from the bank or Hecto Financial.
- The response code field in the common header is set to SPACE on request and to the corresponding error code on response.
- Response code VTIM indicates a response timeout session error, not an error response.
Need technical support?
Code Samples
HectoFinancial GitHub