Inter-Bank Transfer Failure Notification (3000/100)
Notified when the response code for an inter-bank transfer (2000/100) was normal but the inter-bank processing failed.
Message Information
| Item | Notification | Response |
|---|---|---|
| Message code | 3000 | 3100 |
| Business type | 100 | 100 |
| Direction | Bank → Merchant | Merchant → Bank |
Final Result Update Required
When an inter-bank transfer failure notification is received, the final status of the transfer must be updated to 'failed'. Even if a normal response was received, the transfer has failed when this notification arrives.
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: 3000, response: 3100) |
| 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 | Original transaction message sequence number | 100 | 6 | Original message sequence number of the transfer transaction |
| 2 | Withdrawal account number | 106 | 15 | Original transaction withdrawal account number |
| 3 | Deposit bank | 121 | 3 | Original transaction deposit bank code |
| 4 | Deposit account number | 124 | 15 | Original transaction deposit account number |
| 5 | Requested amount | 139 | 13 | Original transaction requested amount |
| 6 | Normal processing amount | 152 | 13 | Successfully processed amount |
| 7 | Failed processing amount | 165 | 13 | Failed processing amount |
| 8 | Split processing count | 178 | 2 | Split processing count |
| 9 | Split processing number | 180 | 2 | Split processing number |
| 10 | Inter-bank message sequence number | 182 | 6 | Inter-bank message sequence number |
| 11 | Deposit failure notification amount | 188 | 13 | Deposit failure notification amount |
| 12 | ERROR CODE | 201 | 4 | Interbank network error code |
| 13 | Interbank network unique transaction number | 205 | 13 | NH Bank exclusive |
| 14 | Reserved | 218 | 82 | SPACE |
Message Structure
Inter-Bank Transfer Failure 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
Original transaction message sequence number6 · 100
Withdrawal account number15 · 106
Deposit bank3 · 121
Deposit account number15 · 124
Requested amount13 · 139
Normal processing amount13 · 152
Failed processing amount13 · 165
Split processing count2 · 178
Split processing number2 · 180
Inter-bank message sequence number6 · 182
Deposit failure notification amount13 · 188
ERROR CODE4 · 201
Interbank network unique transaction number13 · 205
Reserved82 · 218
필수
선택
응답전용 / 예비
길이 · 위치Response Parameters (Merchant → Bank)
After receiving the notification, the response message (3100/100) must be sent.
| No | Field | Position | Length | Description |
|---|---|---|---|---|
| 1-14 | (Same) | - | - | Return the received content as-is |
Processing Flow
1. Merchant → Bank: Inter-bank transfer request (2000/100)
2. Bank → Merchant: Inter-bank transfer response - Normal (2100/100)
3. (Inter-bank processing failure occurs)
4. Bank → Merchant: Inter-bank transfer failure notification (3000/100)
5. Merchant → Bank: Inter-bank transfer failure response (3100/100)
6. Merchant: Update the transaction status to 'failed'
NOTE
Bank/Merchant Differences
The occurrence and timing of inter-bank transfer failure notifications may vary by bank and merchant.
Need technical support?
Code Samples
HectoFinancial GitHub