Foreign Currency Remittance Result Inquiry (7000/950)
Used to inquire the processing result of a foreign currency remittance request (2000/400).
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 7000 | 7100 |
| Business type | 950 | 950 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2000 bytes (Common Header 100 + Individual Data Block 1900) |
Woori Bank Not Supported
This message does not exist for Woori Bank. For Woori Bank remittance result inquiries, use the missing transaction inquiry message (3000/800).
NOTE
Hana Bank Amount Notation Difference
For Hana Bank, unlike the foreign currency remittance request (2000/400) where 1 USD is expressed as 1000, the 7000/950 message returns 1. For decimal amounts, the value is returned with the decimal point character included (e.g., 5.5).
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 (950) |
| 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 Data Block (1900 bytes)
Request/Response Parameters
| No | Field | Position | Length | Request | Response | Description |
|---|---|---|---|---|---|---|
| 1 | Request date | 100 | X(8) | Y | - | YYYYMMDD |
| 2 | Original transaction message sequence number | 108 | X(6) | Y | - | Message sequence number of the transfer transaction |
| 3 | Withdrawal account number | 114 | X(15) | - | Y | |
| 4 | Deposit bank code | 129 | X(3) | - | Y | |
| 5 | Deposit account number | 132 | X(35) | - | Y | |
| 6 | Remittance currency | 167 | X(3) | - | Y | ISO CODE (e.g., USD, JPY) |
| 7 | Transfer requested amount | 170 | 9(15) | - | Y | |
| 8 | Successfully processed amount | 185 | 9(15) | - | Y | |
| 9 | Unprocessable amount | 200 | 9(15) | - | Y | |
| 10 | Fee | 215 | 9(15) | - | Y | |
| 11 | Transfer time | 230 | 9(6) | - | Y | Bank processing time |
| 12 | Processing result | 236 | X(4) | - | Y | 0000 or ERROR CODE |
| 13 | Reserved | 240 | X(1760) | - | - | SPACE |
NOTE
IBK Restriction
Industrial Bank of Korea (IBK) does not return the fee amount.
Message Structure
Request Message (2000 bytes)2000 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 Data Block1900B · offset 100
Request date8 · 100
Original transaction message sequence number6 · 108
Withdrawal account number15 · 114
Deposit bank code3 · 129
Deposit account number35 · 132
Remittance currency3 · 167
Transfer requested amount15 · 170
Successfully processed amount15 · 185
Unprocessable amount15 · 200
Fee15 · 215
Transfer time6 · 230
Processing result4 · 236
Reserved1760 · 240
필수
선택
응답전용 / 예비
길이 · 위치Response Codes
Response codes vary by bank. The full code list can be requested from the relevant bank or Hecto Financial.
- The response code field in the Common Header must be set to SPACE in request messages; the bank sets the appropriate error code in response messages.
- The response code VTIM indicates a session timeout (not an error response). If 3000/700 is not received, verify using 3000/800.
Need technical support?
Code Samples
HectoFinancial GitHub