Collection Withdrawal Account Registration/Termination (2000/550)
Registers or terminates a customer's withdrawal consent account for collection (auto-transfer). Sent from the merchant to the bank.
Message Information
| Item | Request | Response |
|---|---|---|
| Message code | 2000 | 2100 |
| Business type | 550 | 550 |
| Direction | Merchant → Bank | Bank → Merchant |
| Message size | 300 bytes (Common header 100 + Individual body 200) |
NOTE
Registration/Termination Request
This message is used when the merchant registers or terminates a customer's withdrawal consent account at the bank. For notifications when a customer terminates directly at the bank, refer to the separate message (2000/650).
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 (550) |
| 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 | Request | Response | Description |
|---|---|---|---|---|---|---|
| 1 | Identification code | 100 | X(1) | Y | - | Set 'D' |
| 2 | Processing sequence number | 101 | 9(7) | - | Y | Data processing sequence number |
| 3 | Bank code | 108 | 9(3) | Y | - | Message recipient bank code |
| 4 | Account number | 111 | X(16) | Y | - | Application account number |
| 5 | Application type | 127 | 9(1) | Y | - | 1: New registration, 2: Termination |
| 6 | Auto payment date | 128 | X(2) | - | - | |
| 7 | Branch code | 130 | 9(7) | Y | - | Set "0000000" |
| 8 | Application date | 137 | X(8) | Y | - | Customer application date (SC Bank must set to current date) |
| 9 | Processing status | 145 | X(1) | - | Y | Y: Normal, N: Failed |
| 10 | Failure code | 146 | X(4) | - | Y | Error code on failure |
| 11 | Real-name number check | 150 | X(1) | Y | - | Y: Check, N: No check |
| 12 | Real-name number | 151 | X(13) | Y | - | Date of birth (YYMMDD) or business registration number |
| 13 | Payer identification number | 164 | X(20) | Y | - | |
| 14 | Firm banking institution code | 184 | X(10) | Conditional | - | Set when using firm banking bulk transfer service concurrently |
| 15 | Customer contact number | 194 | X(20) | Conditional | - | Used for KB Kookmin Bank window registration |
| 16 | Account holder name | 214 | X(30) | Conditional | - | Used for KB Kookmin Bank window registration |
| 17 | Reserved 1 | 244 | X(30) | - | - | |
| 18 | Consent record type | 274 | X(1) | Conditional | - | Set for partial exemption and submission institutions |
| 19 | Withdrawal bank institution code | 275 | X(20) | Conditional | - | Set for partial exemption institutions |
| 20 | Reserved 2 | 295 | X(5) | - | - |
Consent Record Guidelines
Consent Record Type Values
| Value | Description |
|---|---|
| 1 | Written |
| 2 | Certified digital signature |
| 3 | General digital signature |
| 4 | Voice recording |
| 5 | ARS |
| 6 | Other electronic document |
| 7 | Private electronic document (certificate extension .der) |
Institution Classification for Submission
Consent Record Management Notice
Institutions must confirm their classification with their contracted bank. Submission institutions must submit evidence including identification values for real-time transactions by 12:00 on the next business day (via FB0110 file transmission).
| Classification | Target |
|---|---|
| Exempt | Government agencies under the Government Organization Act, local governments under the Local Autonomy Act |
| Temporary exempt | Public enterprises under the Act on the Management of Public Institutions, school corporations under the Education Act |
| Partial exempt | Financial companies under the Financial Real-Name Transactions Act, publicly listed corporations subject to external audits, political parties under the Political Parties Act |
| Submission institutions | All service users except exempt institutions |
Message Structure
Collection Withdrawal Account Registration/Termination 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
Identification code1 · 100
Processing sequence number7 · 101
Bank code3 · 108
Account number16 · 111
Application type1 · 127
Auto payment date2 · 128
Branch code7 · 130
Application date8 · 137
Processing status1 · 145
Failure code4 · 146
Real-name number check1 · 150
Real-name number13 · 151
Payer identification number20 · 164
Firm banking institution code10 · 184
Customer contact number20 · 194
Account holder name30 · 214
Reserved 130 · 244
Consent record type1 · 274
Withdrawal bank institution code20 · 275
Reserved 25 · 295
필수
선택
응답전용 / 예비
길이 · 위치Response Codes
Response codes vary by bank. The code list can be requested from the bank or Hecto Financial.
- The response code field in the common header is set to SPACE on request and to the corresponding error code on response.
- Response code VTIM indicates a response timeout session error, not an error response.
Need technical support?
Code Samples
HectoFinancial GitHub