Foreign Currency Remittance Request (2000/400)
Message for transferring foreign currency funds to an overseas or domestic foreign currency account. Only same-currency transfers are supported.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 2000 | 2100 |
| Business type | 400 | 400 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2000 bytes (Common Header 100 + Individual Data Block 1900) |
Same-Currency Transfers Only
Foreign currency remittance requests are only supported for same-currency transfers. Example: USD→USD, JPY→JPY
Woori Bank Same-Bank Transaction Note
For Woori Bank, if no message response is received when the remittance type is 3 (Same-Bank transfer), you must confirm by phone with the bank or Hecto Financial.
NOTE
Confirming Remittance Result
For overseas remittance (1) and domestic remittance (2), the foreign currency remittance result notification (3000/700) must be confirmed as the final step. Same-Bank transfer (3) and KFTC-routed (4) transactions are completed upon the remittance response.
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: 2000, response: 2100) |
| 5 | Business type code | 28 | 3 | Y | Business type (400) |
| 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 Parameters
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Customer number | 100 | 9(10) | Y | Business registration number |
| 2 | Debit account number | 110 | X(16) | Y | Account number pre-registered with the bank |
| 3 | Recall code | 126 | X(6) | Y | Used after agreement with the bank |
| 4 | Remittance amount | 132 | 9(15) | Y | Includes 3 decimal places (12,3) |
| 5 | Remittance currency | 147 | X(3) | Y | ISO CODE (e.g., USD, JPY) |
| 6 | Remittance type | 150 | X(1) | Y | 1: Overseas remittance, 2: Domestic remittance, 3: Same-Bank transfer, 4: Domestic remittance (KFTC-routed), P: Position transaction (SC Bank) |
| 7 | Remitter name (English) | 151 | X(35) | Y | Sender |
| 8 | Beneficiary name (English) | 186 | X(35) | Y | Recipient |
| 9 | Beneficiary account number | 221 | X(35) | Y | At least one of beneficiary account number or address is required |
| 10 | Beneficiary address | 256 | X(3*35) | Y | At least one of beneficiary account number or address is required |
| 11 | Instructions to beneficiary | 361 | X(4*35) | N | |
| 12 | Counterpart country code | 501 | X(2) | Y | |
| 13 | Remittance to sanctioned country | 503 | X(1) | N | Set 'Y' when remitting to a sanctioned country |
| 14 | Beneficiary bank code | 504 | X(11) | Y | BIC CODE / Same-Bank DORRES CODE |
| 15 | Beneficiary bank name and address | 515 | X(4*35) | N | May be omitted if bank code is entered |
| 16 | Intermediary bank 1 | 655 | X(2*35) | N | Used when specifically designated |
| 17 | Intermediary bank 2 | 725 | X(2*35) | N | |
| 18 | Intermediary bank 3 | 795 | X(2*35) | N | |
| 19 | Fee debit account number | 865 | X(16) | Y | |
| 20 | Overseas bank fee bearer | 881 | X(1) | Y | 1: Remitter bears, 2: Beneficiary bears, 3: Both bear (Hana/IBK exclusive) |
| 21 | Overseas bank fee debit account designation | 882 | X(1) | Y | 1: Debit account, 2: Fee debit account |
| 22 | Payment purpose code | 883 | 9(3) | N | Choose one: payment purpose code or payment purpose (Korean) |
| 23 | Payment purpose | 886 | X(35) | N | Choose one: payment purpose code or payment purpose (Korean) |
| 24 | Price terms | 921 | X(3) | N | Required for deferred payment remittances exceeding USD 1,000 |
| 25 | H.S CODE | 924 | 9(10) | N | |
| 26 | Import declaration number | 934 | X(22) | N | |
| 27 | Import purpose | 956 | X(1) | N | |
| 28 | Memo | 957 | X(14) | N | Set when remittance type is 3 (Same-Bank transfer) |
| 29 | Beneficiary account holder name | 971 | X(22) | - | Set in response |
| 30 | Debit account balance | 993 | 9(15) | - | Set in response |
| 31 | Beneficiary email address 1 | 1008 | X(50) | N | Up to 5 recipients can be notified per remittance |
| 32 | Beneficiary email address 2 | 1058 | X(50) | N | |
| 33 | Beneficiary email address 3 | 1108 | X(50) | N | |
| 34 | Beneficiary email address 4 | 1158 | X(50) | N | |
| 35 | Beneficiary email address 5 | 1208 | X(50) | N |
Bank-Specific Additional Fields
The following fields are only used by specific banks or specific remittance types.
| No | Field | Position | Length | Condition | Description |
|---|---|---|---|---|---|
| 36 | Non-trade post-management number | 1258 | X(16) | Conditional | Issued by branch. Based on trade/non-trade, business entity, reason, and currency code |
| 37 | Spare field | 1274 | X(4) | Conditional | |
| 38 | Bank code | 1278 | X(3) | Remittance type 4 | Added for KFTC-routed transactions |
| 39 | Beneficiary branch giro code | 1281 | X(7) | Remittance type 4 | Added for KFTC-routed transactions |
| 40 | Residence classification | 1288 | X(2) | Remittance type 4 | First: remitter residence, Second: beneficiary residence (Resident: 1, Non-resident: 2). Woori Bank: set with 6000/450 result value; Hana Bank: only 11 or 22 allowed |
| 41 | Account holder inquiry sequence number | 1290 | 9(6) | Remittance type 4, required for Woori Bank | |
| 42 | Foreign exchange bank designation code | 1296 | X(2) | Woori Bank | |
| 43 | Foreign exchange bank designation resident ID or passport number | 1298 | X(13) | Woori Bank | |
| 44 | Financial currency code | 1311 | 9(3) | Woori Bank | |
| 45 | Media classification | 1314 | X(2) | Woori Bank | |
| 46 | Settlement bank fee | 1316 | X(18) | Woori Bank | |
| 47 | Payment purpose code | 1334 | 9(5) | Required for remittance types 1, 2 | |
| 48 | Scheduled date | 1339 | 9(8) | IBK | |
| 49 | Debit amount (KRW equivalent) | 1347 | 9(15) | SC Bank | |
| 50 | Applied exchange rate | 1362 | 9(1) | SC Bank | 1: system rate, 2: contracted rate |
| 51 | Handling fee bearer classification | 1363 | 9(1) | SC Bank | 1: Remitter bears, 2: Beneficiary bears |
| 52 | Reserved | 1364 | X(636) | - | SPACE |
Notes by Remittance Type
Fields Used for Same-Bank Foreign Currency Account Transfer (Remittance Type: 3)
- Debit account number: Debit foreign currency account number
- Recall code
- Remittance amount
- Remittance currency
- Remittance type: 3 (Same-Bank transfer)
- Fee debit account number: Credit foreign currency account number
- Memo: Notes to the counterparty such as credit reason
- Beneficiary account holder name
- Debit foreign currency account balance
Bank-Specific Notes
For IBK, when remittance type is domestic (2), the payment purpose code must be set to 10001. Standard Chartered Bank Korea does not support KFTC-routed domestic remittance (remittance type 4).
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
Customer number10 · 100
Debit account number16 · 110
Recall code6 · 126
Remittance amount15 · 132
Remittance currency3 · 147
Remittance type1 · 150
Remitter name (English)35 · 151
Beneficiary name (English)35 · 186
Beneficiary account number35 · 221
Beneficiary address105 · 256
Instructions to beneficiary140 · 361
Counterpart country code2 · 501
Remittance to sanctioned country1 · 503
Beneficiary bank code11 · 504
Beneficiary bank name and address140 · 515
Intermediary bank 170 · 655
Intermediary bank 270 · 725
Intermediary bank 370 · 795
Fee debit account number16 · 865
Overseas bank fee bearer1 · 881
Overseas bank fee debit account designation1 · 882
Payment purpose code3 · 883
Payment purpose35 · 886
Price terms3 · 921
H.S CODE10 · 924
Import declaration number22 · 934
Import purpose1 · 956
Memo14 · 957
Beneficiary account holder name22 · 971
Debit account balance15 · 993
Beneficiary email address 150 · 1008
Beneficiary email address 250 · 1058
Beneficiary email address 350 · 1108
Beneficiary email address 450 · 1158
Beneficiary email address 550 · 1208
Non-trade post-management number16 · 1258
Spare field4 · 1274
Bank code3 · 1278
Beneficiary branch giro code7 · 1281
Residence classification2 · 1288
Account holder inquiry sequence number6 · 1290
Foreign exchange bank designation code2 · 1296
Foreign exchange bank designation resident ID or passport number13 · 1298
Financial currency code3 · 1311
Media classification2 · 1314
Settlement bank fee18 · 1316
Payment purpose code5 · 1334
Scheduled date8 · 1339
Debit amount (KRW equivalent)15 · 1347
Applied exchange rate1 · 1362
Handling fee bearer classification1 · 1363
Reserved636 · 1364
필수
선택
응답전용 / 예비
길이 · 위치Response Codes
Response codes vary by bank. You can request the code list from the bank or Hecto Financial.
- The response code field in the Common Header is set to SPACE in request messages and to the applicable error code in response messages.
- The VTIM response code indicates a response timeout session error and is not an error response. (If 3000/700 is not received, verify using 3000/800.)
VTIM Response
The VTIM response code indicates a response timeout. This is a session error, not an error response. If the foreign currency remittance result notification (3000/700) is not received, verify using 3000/800 (missing sequence inquiry).
Need technical support?
Code Samples
HectoFinancial GitHub