Transfer Result Inquiry (7000/100)
Queries the processing result of transfer messages (2000/100, 2000/200).
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 7000 | 7100 |
| Business type | 100 | 100 |
| Direction | Merchant → Bank | Bank → Merchant |
Mandatory Usage
When using transfer messages, always confirm the final result using the transfer result inquiry. In particular, if VTIM (response timeout) is received, verify the result using this message after 5 minutes.
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 (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)
Request/Response Parameters
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Original transaction message sequence number | 100 | 6 | Y | Message sequence number of the transfer message to query |
| 2 | Withdrawal account number | 106 | 15 | - | Master account number (response) |
| 3 | Deposit bank code | 121 | 3 | - | Transaction account bank code (response) |
| 4 | Deposit account number | 124 | 15 | - | Transaction account number (response) |
| 5 | Requested amount | 139 | 13 | - | Transfer requested amount (response) |
| 6 | Normal processing amount | 152 | 13 | - | Successfully processed amount (response) |
| 7 | Failed processing amount | 165 | 13 | - | Failed processing amount (response) |
| 8 | Fee | 178 | 9 | - | Transfer fee (response) |
| 9 | Transfer time | 187 | 6 | - | Bank processing time (response) |
| 10 | Processing result | 193 | 4 | - | Processing result code (response). Refer to each bank's response code list |
| 11 | Inquiry type | 197 | 2 | N | Required when using KBank/KakaoBank |
| 12 | Reserved | 199 | 101 | - | SPACE |
Message Structure
Transfer Result Inquiry Request 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 bank code3 · 121
Deposit account number15 · 124
Requested amount13 · 139
Normal processing amount13 · 152
Failed processing amount13 · 165
Fee9 · 178
Transfer time6 · 187
Processing result4 · 193
Inquiry type2 · 197
Reserved101 · 199
필수
선택
응답전용 / 예비
길이 · 위치Response Parameters
| No | Field | Position | Length | Description |
|---|---|---|---|---|
| 6 | Normal processing amount | 152 | 13 | Successfully processed amount |
| 7 | Failed processing amount | 165 | 13 | Failed processing amount |
| 8 | Fee | 178 | 9 | Transfer fee |
| 9 | Transfer time | 187 | 6 | Bank processing time |
| 10 | Processing result | 193 | 4 | Processing result code. Refer to each bank's response code list |
Usage Scenario
1. Merchant → Bank: Transfer request (2000/100)
2. Bank → Merchant: Transfer response - VTIM (response timeout)
3. (Wait 5 minutes)
4. Merchant → Bank: Transfer result inquiry (7000/100)
5. Bank → Merchant: Transfer result response (7100/100)
- Confirm final result using the original transaction response code
Notes
- Set the original transaction message sequence number accurately.
- If the processing result is a "processing in progress" code, send the transfer result inquiry message periodically until a different result is received.
- The processing result is determined by the common header response code or the individual body processing result. (Cases may exist where a failure is indicated in the response code without setting the processing result.)
- SC Bank has separate auto-transfer result inquiry (7000/110) and payment transfer result inquiry.
- Inquiry type: KBank (1: same-bank/inter-bank transfer, 2: collection transfer), KakaoBank (1: same-bank/inter-bank transfer, 3: collection transfer)
Need technical support?
Code Samples
HectoFinancial GitHub