Foreign Currency Remittance Request (MX) (2000/401)
MX message for transferring foreign currency funds to an overseas or domestic foreign currency account. This message was newly introduced in XML format following the discontinuation of the SWIFT MT message (2000/400).
NOTE
Background of MX Message Introduction
The MX message (2000/401) was newly introduced due to the discontinuation of the SWIFT MT message (2000/400) previously used for inbound/outbound remittance transactions. The format changed from MT message (Text) to MX message (XML), enabling a broader range of message exchanges.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 2000 | 2100 |
| Business type | 401 | 401 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 2500 bytes (Common Header 100 + Individual Data Block 2400) |
NOTE
Confirming Remittance Result
For overseas remittance (1) and domestic remittance (2), the foreign currency remittance result notification (MX) (3000/701) must be confirmed as the final step. Same-Bank transfer (3) and KFTC-routed (4) transactions are completed upon the remittance response.
Woori Bank Same-Bank Transaction Note
For Woori Bank, if no message response is received when the transfer type code is 3 (Same-Bank transfer), you must confirm by phone with the bank or Hecto Financial.
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 | X(9) | Y | Recipient's TRANSACTION CODE (SETTLEBNK or SPACE) |
| 2 | Merchant ID | 9 | X(12) | Y | Merchant ID assigned by each opening bank |
| 3 | Bank code | 21 | 9(3) | Y | Opening bank code contracted for firm banking |
| 4 | Message type code | 24 | X(4) | Y | Message code (request: 2000, response: 2100) |
| 5 | Business type code | 28 | X(3) | Y | Business type (401) |
| 6 | Transmission count | 31 | 9(1) | Y | Fixed value '1' |
| 7 | Message sequence number | 32 | 9(6) | Y | Daily unique sequence number (MAX 950,000) |
| 8 | Transmission date | 38 | 9(8) | Y | Message transmission date (YYYYMMDD) |
| 9 | Transmission time | 46 | 9(6) | Y | Message transmission time (hhmmss) |
| 10 | Response code | 52 | X(4) | - | Response code (error code), SPACE on request |
| 11 | Reserved area | 56 | X(44) | - | Hecto Financial proprietary area |
Individual Data Block (2400 bytes)
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Customer number | 100 | 9(10) | Conditional | Business registration number |
| 2 | Debit account number | 110 | X(16) | Y | Account number pre-registered with the bank |
| 3 | Recall code | 126 | X(6) | Conditional | Used after agreement with the bank |
| 4 | Transaction amount | 132 | 9(15) | Y | Includes 3 decimal places (12,3) |
| 5 | Currency code | 147 | X(3) | Y | ISO CODE (e.g., USD, JPY) |
| 6 | Transfer type code | 150 | X(1) | Y | 1: Overseas remittance, 2: Domestic remittance (SWIFT), 3: Same-Bank transfer, 4: Domestic remittance (KFTC) - available at specific banks only |
| 7 | Remitter name | 151 | X(140) | Y | English |
| 8 | Remitter country code | 291 | X(2) | Y | Remitter country code |
| 9 | Remitter address city | 293 | X(35) | Conditional | |
| 10 | Remitter address street | 328 | X(70) | Conditional | |
| 11 | Remitter address floor | 398 | X(70) | Conditional | |
| 12 | Remittance purpose code | 468 | X(4) | Conditional | |
| 13 | Remittance purpose instruction | 472 | X(70) | Conditional | |
| 14 | Remitter LEI | 542 | X(20) | Conditional | |
| 15 | Beneficiary name | 562 | X(140) | Y | English |
| 16 | Credit account number | 702 | X(35) | Y | |
| 17 | Credit country code | 737 | X(2) | Y | Beneficiary country code (based on address) |
| 18 | Beneficiary address city | 739 | X(35) | Y | |
| 19 | Beneficiary address street | 774 | X(70) | Conditional | Beneficiary address detail 1 |
| 20 | Beneficiary address floor | 844 | X(70) | Conditional | Beneficiary address detail 2 |
| 21 | Beneficiary postal code | 914 | X(16) | Conditional | |
| 22 | Instructions to beneficiary | 930 | X(140) | Conditional | |
| 23 | Beneficiary LEI | 1070 | X(20) | Conditional | Beneficiary legal entity identifier |
| 24 | Remittance to sanctioned country | 1090 | X(1) | Y | Default N / Set Y for sanctioned country remittance |
| 25 | Credit BIC bank code | 1091 | X(11) | Y | BIC CODE. For Hana Bank KFTC transactions, use 3-digit bank code |
| 26 | Credit bank name | 1102 | X(140) | Conditional | May be omitted if BIC code is entered |
| 27 | Credit bank country code | 1242 | X(2) | Conditional | May be omitted if BIC code is entered |
| 28 | Credit bank address city | 1244 | X(35) | Conditional | May be omitted if BIC code is entered |
| 29 | Credit bank address street | 1279 | X(70) | Conditional | May be omitted if BIC code is entered |
| 30 | Credit bank address floor | 1349 | X(70) | Conditional | May be omitted if BIC code is entered |
| 31 | Country-specific bank code | 1419 | X(5) | Conditional | NCC code, 5 English characters (e.g., US: USABA) |
| 32 | Country-specific bank code value | 1424 | X(28) | Conditional | Member Identification (local payment network bank identifier of beneficiary country) |
| 33 | Intermediary bank 1 | 1452 | X(70) | Conditional | Standard Chartered Bank Korea (intermediary bank name 35 + city 35) |
| 34 | Intermediary bank 2 | 1522 | X(70) | Conditional | Standard Chartered Bank Korea (intermediary bank street) |
| 35 | Intermediary bank 3 | 1592 | X(70) | Conditional | Standard Chartered Bank Korea (intermediary bank floor - optional) |
| 36 | Fee account number | 1662 | X(16) | Conditional | Standard Chartered Bank Korea: set SPACE |
| 37 | Fee bearer code | 1678 | X(1) | Y | 1: Remitter bears, 2: Beneficiary bears, 3: Both bear (some banks only) |
| 38 | Fee debit type code | 1679 | X(1) | Y | 1: Debit account, 2: Fee debit account |
| 39 | Payment purpose code | 1680 | X(5) | Y | Required when transfer type code is 1 or 2 |
| 40 | Payment purpose | 1685 | X(35) | Conditional | Not required if payment purpose code is entered |
| 41 | Price terms code | 1720 | X(3) | Conditional | Required for deferred payment remittances exceeding USD 1,000 |
| 42 | H.S CODE | 1723 | X(10) | Conditional | Required for deferred payment remittances exceeding USD 1,000 |
| 43 | Import declaration number | 1733 | X(22) | Conditional | Required for deferred payment remittances exceeding USD 1,000 |
| 44 | Import purpose | 1755 | X(1) | Conditional | Required for deferred payment remittances exceeding USD 1,000 |
| 45 | Memo | 1756 | X(14) | Conditional | Used when transfer type code is 3 (Same-Bank transfer) |
| 46 | Credit account holder name | 1770 | X(22) | Conditional | Used when transfer type code is 3 (Same-Bank transfer) |
| 47 | Debit account balance | 1792 | X(15) | Conditional | Set in response |
| 48 | Beneficiary email address 1 | 1807 | X(50) | Conditional | Not available for Standard Chartered Bank Korea |
| 49 | Beneficiary email address 2 | 1857 | X(50) | Conditional | Not available for Standard Chartered Bank Korea |
| 50 | Beneficiary email address 3 | 1907 | X(50) | Conditional | Not available for Standard Chartered Bank Korea |
| 51 | Expected import date type code | 1957 | X(1) | Conditional | Hana Bank. Used for advance payment method. 1: Within 1 year, 2: Over 1 year |
| 52 | Entrepot trade export transaction flag | 1958 | X(1) | Conditional | Hana Bank (Y/N) |
| 53 | Credit bank code | 1959 | X(3) | Conditional | Required for Woori Bank & transfer type code 4 (domestic KFTC) |
| 54 | Handling branch code | 1962 | X(7) | Conditional | Woori Bank & transfer type code 4 (domestic KFTC). Beneficiary branch giro code |
| 55 | Residence classification code | 1969 | X(2) | Conditional | Woori Bank & transfer type code 4 (domestic KFTC) |
| 56 | Account holder inquiry sequence number | 1971 | X(6) | Conditional | Sequence number from prior counterpart account holder inquiry |
| 57 | Foreign exchange bank designation code | 1977 | X(2) | Conditional | Woori Bank exclusive |
| 58 | Foreign exchange bank designation real-name number | 1979 | X(13) | Conditional | Woori Bank exclusive |
| 59 | Financial currency code | 1992 | X(3) | Conditional | Woori Bank exclusive |
| 60 | Intermediary BIC bank code | 1995 | X(11) | Conditional | Standard Chartered Bank Korea exclusive. Required when intermediary bank info is set |
| 61 | Intermediary bank country code | 2006 | X(2) | Conditional | Standard Chartered Bank Korea exclusive |
| 62 | KRW debit amount | 2008 | X(15) | Conditional | Standard Chartered Bank Korea exclusive |
| 63 | Applied exchange rate type code | 2023 | X(1) | Conditional | Standard Chartered Bank Korea exclusive. 1: system rate, 2: contracted rate |
| 64 | Handling fee bearer code | 2024 | X(1) | Conditional | Standard Chartered Bank Korea exclusive. 1: Beneficiary bears (BEN), 2: Remitter bears (OUR) |
| 65 | Credit bank BIC code type | 2025 | X(1) | Conditional | Standard Chartered Bank Korea exclusive (required). 1: BIC, 2: NON-BIC |
| 66 | Intermediary bank BIC code type | 2026 | X(1) | Conditional | Standard Chartered Bank Korea exclusive (required when intermediary bank is entered). 1: BIC, 2: NON-BIC |
| 67 | Reserved | 2027 | X(473) | - | SPACE |
Message Structure
Request Message (2500 bytes)2500 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 Block2400B · offset 100
Customer number10 · 100
Debit account number16 · 110
Recall code6 · 126
Transaction amount15 · 132
Currency code3 · 147
Transfer type code1 · 150
Remitter name140 · 151
Remitter country code2 · 291
Remitter address city35 · 293
Remitter address street70 · 328
Remitter address floor70 · 398
Remittance purpose code4 · 468
Remittance purpose instruction70 · 472
Remitter LEI20 · 542
Beneficiary name140 · 562
Credit account number35 · 702
Credit country code2 · 737
Beneficiary address city35 · 739
Beneficiary address street70 · 774
Beneficiary address floor70 · 844
Beneficiary postal code16 · 914
Instructions to beneficiary140 · 930
Beneficiary LEI20 · 1070
Remittance to sanctioned country1 · 1090
Credit BIC bank code11 · 1091
Credit bank name140 · 1102
Credit bank country code2 · 1242
Credit bank address city35 · 1244
Credit bank address street70 · 1279
Credit bank address floor70 · 1349
Country-specific bank code5 · 1419
Country-specific bank code value28 · 1424
Intermediary bank 170 · 1452
Intermediary bank 270 · 1522
Intermediary bank 370 · 1592
Fee account number16 · 1662
Fee bearer code1 · 1678
Fee debit type code1 · 1679
Payment purpose code5 · 1680
Payment purpose35 · 1685
Price terms code3 · 1720
H.S CODE10 · 1723
Import declaration number22 · 1733
Import purpose1 · 1755
Memo14 · 1756
Credit account holder name22 · 1770
Debit account balance15 · 1792
Beneficiary email address 150 · 1807
Beneficiary email address 250 · 1857
Beneficiary email address 350 · 1907
Expected import date type code1 · 1957
Entrepot trade export transaction flag1 · 1958
Credit bank code3 · 1959
Handling branch code7 · 1962
Residence classification code2 · 1969
Account holder inquiry sequence number6 · 1971
Foreign exchange bank designation code2 · 1977
Foreign exchange bank designation real-name number13 · 1979
Financial currency code3 · 1992
Intermediary BIC bank code11 · 1995
Intermediary bank country code2 · 2006
KRW debit amount15 · 2008
Applied exchange rate type code1 · 2023
Handling fee bearer code1 · 2024
Credit bank BIC code type1 · 2025
Intermediary bank BIC code type1 · 2026
Reserved473 · 2027
필수
선택
응답전용 / 예비
길이 · 위치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/701 is not received, verify using 3000/801.)
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 (MX) (3000/701) is not received, verify using 3000/801 (missing sequence inquiry).
Need technical support?
Code Samples
HectoFinancial GitHub