How to Understand Error Codes of TMS and the Agent

From wizarPOS

Error Format

[L/LS/S]-[module code]-[error code], For example: L_01_28

  • L: General error from terminal.
  • LS: Network error from terminal.
  • S: General error from WizarView server.

Module code

  • 01: Adapt agent parameter
  • 02: Adapt device parameter
  • 03: Adapt network parameter
  • 04: Reset administrator password
  • 05: Uninstall app from terminal
  • 06: Update app
  • 07: Update communication key
  • 08: Upload app status
  • 09: Upload app parameter status
  • 10: Upload system event
  • 11: Upload app which terminal has installed
  • 12: Upload log
  • 13: Terminal register
  • 14: Upload error log when turn on terminal
  • 15: Update firmware patch
  • 16: Update Unionpay key
  • 17: Upload app info
  • A: Administrator login
  • B: Administrator logout
  • C: Task when turn on terminal
  • D: Modify Administrator password
  • DT: Download App/firmware/parameter file
  • E: Mount SD Card
  • F: Collect system event
  • G: Tip message of install firmware
  • H: Install app
  • I: Install parameter file
  • J: Install firmware

Error code

For L

  • 0: Network error
  • 999: Unknown error
  • 10: Install app error
  • 11: Uninstall app error
  • 12: Install parameter error
  • 13: Install firmware error
  • 14: Register address can not access
  • 15: Input register address is same with the default register address
  • 16: Communication key message parsing error
  • 17: Can not identify the message from WizarView
  • 18: Verify signature fail by certificate
  • 19: Verify signature fail by communication key
  • 20: HSM error, generate CSR fail
  • 21: HSM error, encrypt data fail
  • 22: Terminal has registered
  • 23: File I/O error
  • 24: Download app error
  • 25: Operation running
  • 26: File is not exist
  • 27: Can not find the app
  • 28: Return fail when call interface
  • 29: The interface is not exist
  • 30: Verify administrator password fail
  • 31: Can not identify file format
  • 32: Can not parse command from WizarView
  • 33: Illegal message from WizarView
  • 34: Customer serial number is null
  • 35: Firmware has existed
  • 36: Download module are working
  • 37: Terminal does not register
  • 38: System event monitor initialize fail
  • 39: Public certificate lost from HSM
  • 40: Encrypt fail from HSM
  • 41: HSM does not initialize
  • 42: SN is not exist
  • 43: Mount SD card fail
  • 44: Terminal initialize fail
  • 45: Have not connected network
  • 46: Download fail, unknown reason
  • 47: Download fail, please check from terminal
  • 48: Can not connect to WizarView
  • 49: Terminal is initializing
  • 50: No permission
  • -888: Parameter error

For S

  • 0: WizarView server has unknown error
  • 1: Operation success
  • 2: SN is null
  • 3: Illegal CSR
  • 4: XMPP login password is null
  • 5: Certificate lost from WizarView server
  • 6: Key of certificate is changed
  • 7: Terminal is not exist
  • 8: No certificate in the terminal
  • 709: Verify signature fail by certificate
  • 710: Verify signature fail by communication key
  • 11: Add open fire user fail
  • 12: No definition for register rule
  • 13: No matched register rule
  • 14: Generate certificate fail
  • 15: PINPAD certificate key changed
  • 16: PINPAD certificate lost
  • 17: Communication key lost, require new key
  • 18: No definition of signature type
  • 19: Invalid signature
  • 20: Transaction type can not support
  • 21: Quick upgrade channel: model type lost
  • 22: Quick upgrade channel: agent config file lost
  • 23: Quick upgrade channel: agent file lost
  • 24: Quick upgrade channel: version code is older than terminal
  • 25: Config app parameter for terminal
  • 26: Communication protocol can not support
  • 27: No SN
  • 30: Don't need update patch
  • 48: Patch exist

For LS

  • 400: Bad request
  • 403: Forbidden
  • 404: Not found the resource
  • 500: Internal server error
  • 503: Bad gateway
  • 504: Gateway timeout

Common error codes

Error Message Description
999 The terminal failed to register due to unknown reasons, please click Update Now.
L_12_33 Server message is illegal
L_13_06 Terminal certificate conflict
L_13_20 CSR failed to generate
L_IA_10(-2) the package archive file is invalid.

INSTALL_FAILED_INVALID_APK = -2.

L_IA_10(-7) Installed package has a different signature than the new package. INSTALL_FAILED_UPDATE_INCOMPATIBLE = -7.
L_IA_10(-9) The new package uses a shared library that is not available. INSTALL_FAILED_MISSING_SHARED_LIBRARY = -9.
L_IA_10(-103) Did not find any certificates in the .apk. INSTALL_PARSE_FAILED_NO_CERTIFICATES = -103.

Maybe developer sign the apk with wrong signature format, e.g. Q2 does not support signature format v2.

L_IA_10(-104) Inconsistent certificates on the files in the .apk. INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES = -104.
L_IA_10(-13) Can't install because provider name is already used by other apk. INSTALL_FAILED_CONFLICTING_PROVIDER= -13.
L_IA_10(-1000000) Install failed because WizarView apk version is lower than terminal used apk. INSTALL_FAILED_OTHER = -1000000.
L_IA_12(27) Apk is not installed according to the package name. PACKAGE_OR_APPINFO_NOT_FOUND = 27.
LS_13_0 WizarView server has unknown error
L_DT_47 Download error