Collection Transfer (2000/200)
Withdraws funds from a collection account to the master account. Used for auto-transfer collection.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 2000 | 2100 |
| Business type | 200 | 200 |
| Direction | Merchant → Bank | Bank → Merchant |
NOTE
Same-Bank Only
Collection transfers are only available from accounts at the opening bank contracted for firm banking.
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 (200) |
| 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 Parameters
| No | Field | Position | Length | Required | Description |
|---|---|---|---|---|---|
| 1 | Withdrawal account number | 100 | 15 | Y | Customer account |
| 2 | Account passbook password | 115 | 8 | - | SPACE |
| 3 | Verification code | 123 | 6 | Y | Verification code (agreed upon with the bank) |
| 4 | Withdrawal amount | 129 | 13 | Y | Transfer amount |
| 5 | Post-deposit balance sign | 142 | 1 | - | Positive: '+', Negative: '-' (response) |
| 6 | Post-deposit balance | 143 | 13 | - | Balance after transaction (response) |
| 7 | Deposit bank code | 156 | 3 | Y | Master account bank code |
| 8 | Deposit account number | 159 | 15 | Y | Merchant master account |
| 9 | Fee | 174 | 9 | - | Transfer fee (response) |
| 10 | Memo | 183 | 14 | Y | Entry printed on the customer account (content agreed upon) |
| 11 | Withdrawal account real-name number | 197 | 13 | Y | Date of birth (YYMMDD) or business registration number |
| 12 | Master account memo | 210 | 12 | N | Entry printed on the master account (agreed upon with the bank) |
| 13 | CMS depositor code | 222 | 16 | N | CMS depositor code |
| 14 | Cashier's check withdrawal amount | 238 | 13 | N | Cashier's check withdrawal amount |
| 15 | Payer identification number | 251 | 20 | Y | Payer identifier |
| 16 | Firm banking institution code | 271 | 10 | N | Set only when using both real-time transfer and firm banking bulk transfer services |
| 17 | Reseller institution area | 281 | 18 | N | Used only when classified as a reseller institution |
| 18 | Reserved | 299 | 1 | - | SPACE |
Message Structure
Collection Transfer 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
Withdrawal account number15 · 100
Account passbook password8 · 115
Verification code6 · 123
Withdrawal amount13 · 129
Post-deposit balance sign1 · 142
Post-deposit balance13 · 143
Deposit bank code3 · 156
Deposit account number15 · 159
Fee9 · 174
Memo14 · 183
Withdrawal account real-name number13 · 197
Master account memo12 · 210
CMS depositor code16 · 222
Cashier's check withdrawal amount13 · 238
Payer identification number20 · 251
Firm banking institution code10 · 271
Reseller institution area18 · 281
Reserved1 · 299
필수
선택
응답전용 / 예비
길이 · 위치
Need technical support?
Code Samples
HectoFinancial GitHub