헥토파이낸셜 개발자센터

Response Codes

These values are returned in the common-header response-code field. If an operation page defines a more specific meaning, follow the operation page.

Success and Format Errors

CodeMeaning
0000Success
F001Invalid message length
F002Invalid SYSTEM ID
F003Invalid sending institution
F004Invalid reaction code
F005Invalid sequence number
F006Invalid send/receive flag
F007Invalid handling institution
F008Invalid handling branch
F009Invalid terminal code
F010Invalid channel code
F011Invalid message code
F012Invalid transaction code
F037Invalid account number
F038Interbank transfer unavailable

Transaction Responses

CodeMeaning
V017Invalid amount
V025Actual depositor information unavailable
V141Institution system failure
V142Institution not opened
V150Non-participating institution
V151Opening institution outside service hours
V210Invalid transaction date
V303Invalid business code
V304Invalid bank code
V309Duplicate transaction
V311Timeout
V330Check-symbol validation error
V370Interbank transfer processing
V401Recipient account missing
V404Account deposit limit exceeded
V407Total amount mismatch
V409Legally restricted account
V410Migrated account
V411Missing or closed account
V412Suspended account
V413Other recipient restriction
V416Payment count exceeded
V417Interbank exchange unavailable
V418Alias or identity-unverified account
V422Invalid transaction amount
V430Opening institution processing transfer
V438Seized or provisionally seized account
V439Suspended account
V450Ledger not found
V451Unsupported operation
V503Check amount mismatch
V602Original message-control number mismatch
V603Original handling date mismatch
V604Original account mismatch
V605Original amount mismatch
V606Other original details mismatch
V612Original transaction unknown
V637Cancellation unavailable
V682Deposit period expired or mismatched
V683Deposit period expired
V712Invalid transaction code
V713Invalid transaction amount
V755Invalid password
V779Transfer unavailable for account
V783Other transaction unavailable, opening institution busy
V799Update bankbook before transaction
V801Handling institution error
V802Opening institution error
V816Account not found
V817Account error
V818Invalid institution code
V834Deposit/withdrawal detail generation error
V835Reconciliation ledger update error
V840Reconciliation information error
V901Insufficient balance
V999Other transaction unavailable
VTIMTimeout

Error-Handling Principles

  • Treat only 0000 as success.
  • VTIM and V311 can represent an unresolved result; follow the operation-specific recovery process.
  • For original-transaction mismatch codes, compare account, date, amount, and transaction number.
  • Show a helpful customer message without exposing sensitive data.
  • Preserve unknown raw codes and map them to a safe default failure state instead of failing to parse.
💬

Need technical support?