Understand Agent Error Codes
Error Format Overview
Errors in the TMS and the agent are formatted as follows:
'[L/LS/S]-[module code]-[error code]'
Example: 'L_01_28'
Error Prefix Explanation
'L': Indicates a general error originating from the terminal.
'LS': Denotes a network-related error from the terminal.
'S': Represents a general error from the WizarView server.
Module code
This part of the error code specifies the module in the system where the error occurred. (Details of module codes should be listed here.)
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
The error code is a specific identifier for the type of error. (A list of common error codes should be provided here.)
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
List out the common error codes, their meanings. This part is crucial for users to understand what each error code signifies.
| 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_15_13(29) | Update firmware patch failed because because the interface is not exist the API version needs update. BAD_API_VERSION = 29. |
L_I_12(27) | Apk is not installed according to the package name. PACKAGE_OR_APPINFO_NOT_FOUND = 27. |
L_I_13 | Install Firmware failed because an unexpected exception. INSTALL_FIRMWARE_FAILED = 13. |
L_I_13(29) | Install Firmware failed because the interface is not exist the API version needs update. BAD_API_VERSION = 29. |
L_I_28 | Install Firmware failed because returning fail when call interface. INVOKE_ADDITIONAL_API_FAILED = 28. |
L_IA_10(-1) | Install apk failed because the package is already installed. INSTALL_FAILED_ALREADY_EXISTS = -1. |
L_IA_10(-2) | The package archive file is invalid. INSTALL_FAILED_INVALID_APK = -2. |
L_IA_10(-3) | Install apk failed because the URI passed in is invalid. INSTALL_FAILED_INVALID_URI = -3. |
L_IA_10(-4) | Install apk failed because the package manager service found that the device didn't have enough storage space to install the app. INSTALL_FAILED_INSUFFICIENT_STORAGE = -4. |
L_IA_10(-5) | Install apk failed because the package is already installed with the same name. INSTALL_FAILED_DUPLICATE_PACKAGE = -5. |
L_IA_10(-6) | Install apk failed because the requested shared user does not exist. INSTALL_FAILED_NO_SHARED_USER = -6. |
L_IA_10(-7) | Installed package has a different signature than the new package. INSTALL_FAILED_UPDATE_INCOMPATIBLE = -7. |
L_IA_10(-8) | Install apk failed because the package is requested a shared user which is already installed on the device and does not have matching signature. INSTALL_FAILED_SHARED_USER_INCOMPATIBLE = -8. |
L_IA_10(-9) | The new package uses a shared library that is not available. INSTALL_FAILED_MISSING_SHARED_LIBRARY = -9. |
L_IA_10(-10) | Install apk failed because the package uses a shared library that is not available. INSTALL_FAILED_REPLACE_COULDNT_DELETE = -10. |
L_IA_10(-11) | Install apk failed because the package failed while optimizing and validating its dex files, either because there was not enough storage or the validation failed. INSTALL_FAILED_DEXOPT = -11. |
L_IA_10(-12) | Can't install because the current SDK version is older than that required by the package. INSTALL_FAILED_OLDER_SDK= -12. |
L_IA_10(-13) | Can't install because provider name is already used by other apk. INSTALL_FAILED_CONFLICTING_PROVIDER= -13. |
L_IA_10(-14) | Install apk failed because the package failed because the current SDK version is newer than that required by the package. INSTALL_FAILED_NEWER_SDK = -14. |
L_IA_10(-15) | Install package failed because it is a test-only package. INSTALL_FAILED_TEST_ONLY = -15. |
L_IA_10(-16) | Install apk failed because the package being installed contains native code, but none that is compatible with the the device's CPU_ABI. INSTALL_FAILED_CPU_ABI_INCOMPATIBLE = -16. |
L_IA_10(-17) | Install apk failed because the package uses a feature that is not available. INSTALL_FAILED_MISSING_FEATURE = -17. |
L_IA_10(-18) | Install apk failed because a secure container mount point couldn't be accessed on external media. INSTALL_FAILED_CONTAINER_ERROR = -18. |
L_IA_10(-19) | Install apk failed because the package couldn't be installed in the specified install location. INSTALL_FAILED_INVALID_INSTALL_LOCATION = -19. |
L_IA_10(-20) | Install apk failed because the media is not available. INSTALL_FAILED_MEDIA_UNAVAILABLE = -20. |
L_IA_10(-21) | Install apk failed because the verification timed out. INSTALL_FAILED_VERIFICATION_TIMEOUT = -21. |
L_IA_10(-22) | Install apk failed because the verification did not succeed. INSTALL_FAILED_VERIFICATION_FAILURE = -22. |
L_IA_10(-23) | Install apk failed because the package changed from what the calling program expected. INSTALL_FAILED_PACKAGE_CHANGED = -23. |
L_IA_10(-24) | Install apk failed because the package is assigned a different UID than it previously held. INSTALL_FAILED_UID_CHANGED = -24. |
L_IA_10(-25) | Install apk failed because WizarView apk version is lower than terminal used apk version |
L_IA_10(-26) | Install apk failed because the package has target SDK low enough to not support runtime permissions. INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE = -26. |
L_IA_10(-100) | Install apk failed because the package does not end with the expected '.apk' extension. INSTALL_PARSE_FAILED_NOT_APK = -100. |
L_IA_10(-101) | Install apk failed because the package is unable to retrieve the AndroidManifest.xml file. INSTALL_PARSE_FAILED_BAD_MANIFEST = -101. |
L_IA_10(-102) | Install apk failed because the package encountered an unexpected exception. INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION = -102. |
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(-105) | Install apk failed because the package encountered a CertificateEncodingException in one of the files in the .apk. INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING = -105. |
L_IA_10(-106) | Install apk failed because the package encountered a bad or missing package name in the manifest. INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME = -106. |
L_IA_10(-107) | Install apk failed because the package encountered a bad shared user id name in the manifest. INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID = -107. |
L_IA_10(-108) | Install apk failed because the package encountered some structural problem in the manifest. INSTALL_PARSE_FAILED_MANIFEST_MALFORMED = -108. |
L_IA_10(-109) | Install apk failed because the package does not find any actionable tags (instrumentation or application) in the manifest. INSTALL_PARSE_FAILED_MANIFEST_EMPTY = -109. |
L_IA_10(-110) | Install apk failed because the system failed to install the package because of system issues. INSTALL_FAILED_INTERNAL_ERROR = -110. |
L_IA_10(-111) | Install apk failed because WizarView apk version is lower than terminal used apk version. INSTALL_FAILED_VERSION_DOWNGRADE = -111. |
L_IA_10(-112) | Install apk failed because the package doesn't have a native library for terminal cpu architecture. INSTALL_FAILED_NO_MATCHING_ABIS = -112. |
L_IA_10(-1000000) | Install apk failed because a reason undefined so far. INSTALL_FAILED_OTHER = -1000000. If agent version is lower than 5239, [L_IA_10(-112)] is included. |
L_IA_13(66) | Firmware installation service execution failed. POSSYS_UNZIP_FAIL = 66. |
LS_XX_49 | Can't connect to wizarView due to network problem. |
LS_13_0 | WizarView server has unknown error. |
L_DT_47 | The terminal can not access download server, because of local network problem or download server is down. |
Last updated