CloudPOS SDK
  • CloudPOS SDK
    • EMV Develop Spec
    • Scanning Service Usage
    • API Specification
    • CloudPOS SDK AAR
    • Java API Samples
    • Permissions
    • Error code
    • MDB Communication Protocal
  • POS_Specs
  • FAQ
    • SDK Error Collection
      • Printer
      • PINPAD
      • Contactless Card
      • IC Card
      • MSR Card
    • Hardware/Repair
      • Recover a Tampered Terminal
      • Learning Tampered Events
      • Remotely Reactivate from Tamper
      • TF (Micro SD) Card Suggestion
      • Understand Tamper Reason
    • Printer
      • Verify Terminal Printer Status
      • Print Unsupported Character Sets
      • Use Terminal Bluetooth Printer
      • Print Images
      • Print QR Codes
      • Evaluate HTML Print Performance
      • Evaluate Print Performance
      • Print with TM T88IV
      • Replace HTML Print Font
      • Java API Printer Operations
      • Understanding Image Print Gaps
      • Print with JavaScript
      • Verify Printer Paper Status
    • USB/Serial Port
      • Install Terminal USB Drivers
      • Install UU Cable Driver
      • Reinstall Production Serial Drivers
      • Linux Serial Driver Installation
      • Serial Port Development
      • Add Linux Udev Rules
      • ReOpen Serial after Wake-up
      • Close Serial after Disconnect
      • Connect Accessory Mode
      • Detect UU Cable Connnected
      • Control Fan via Serial Port
      • List Connected USB Devices
      • Accessory Agent Service D22/Q3
    • Firmware
      • Update Firmware
      • Understand Firmware Naming
      • Compare Engineer/User Modes
      • Configure POS Home Settings
      • Configure POS System Settings
      • Prevent Accidental App Uninstallation
      • Troubleshoot "Agent Stopped" Error
      • Resolve Forgotten Lock Password
      • Utilize Q1 Buttons
      • Adapt Q1 4G
      • Customize Boot Logo/Animation
      • Set Wallpaper
      • Activate Startup Special Mode
      • Install Browsers
      • Understand Firmware External Access
      • Get Terminal Firmware Modes
      • Write Customer Serial Numbers
      • Enable Touch Screen Wake-Up
      • Set User System Properties
      • Enable and Disable MTP
      • Update POS WebView
      • Disable File Explorer for TF/Pendrives
      • Manage Screen On/Off
      • Disable notification badges
      • Scheduled Terminal Reboot Setup
    • Settings Menu
      • Perform Factory Data Reset
      • Understand Settings Menus
      • View Terminal Certificate List
      • Understand Merchant Self Test
      • Use Network Self-Test
      • Change System Language
      • Log in as Administrator
      • Change Administrator's Login Password
      • Update Terminal Time
      • Update Terminal Time Zone
      • Update Time Zone from IP
      • Enable Settings Menu Role Control
      • Update Role Passwords API
      • Disable Bluetooth/Wi Fi
      • Enable/Disable Auto Time Zone
      • Enable/Disable Automatic Time
      • Set Display Sleep
      • Grant Accessibility Permission Automatically
      • Disable Security Lock
      • Access Settings Sub Menu
      • Set Language API
    • Battery/Power
      • Understand Special Charging Indicator
      • Preserve Terminal Battery Life
      • Understand Q2 Low-voltage Shutdown
      • Understand Terminal Battery Performance
      • Understand Counter Mode
      • Turn Off Terminal API
    • SIM/Ethenet/WIFI
      • Disable POS Hotspot
      • Activate POS Hotspot
      • Retrieve Terminal IMEI Number
      • Retrieve Terminal MEID Number
      • Understand Modem Bands
      • Troubleshoot Terminal SIM Signal
      • Resolve SIM Network Issues
      • Troubleshoot Network Search Error
      • Check eSIM Status
      • Ethernet Connectivity Usage
      • Set Communication Mode
      • Troubleshoot USSD Issues
      • Set Preferred Network Type API
      • Add APN API
      • Set Static Ethernet API
      • Enable/Disable Mobile Data API
      • Set Network Operators API
      • Activate eSIM
      • Enable/Disable Ethernet
    • Certificate
      • Apply App Certificates
      • Renew App Certificate
      • App Installation Controls
      • Install CA Certificates
      • Clear Terminal Certificates
      • Understand Certificate Visibility
    • Card
      • Contactless Card Distance
      • NFC Buffer Size Understanding
      • Use Contactless CPU Card
      • Use Felica Card
      • Use Mifare Card
      • Understand PSAM Card Exceptions
      • Optimal Tap Positioning Guide
    • FingerPrint
      • Fingerprint Module Usage Guide
      • Fingerprint DPI Specifications
      • Fingerprint Data Formats
    • Other Development
      • New Android Studio Versions
      • Setup ANDROID HOME
      • App Signing Process
      • Install POS Applications
      • Create First Android App
      • Retrieve Terminal Logs
      • Resolve APK Signature Conflict
      • Obtain Unfiltered Full Log
      • Obtain Terminal Current Location
      • Use Terminal Camera
      • Get Test APKs
      • Learn ADB Commands
      • Get Advanced Demos
      • Import Java SDK in C
      • Obtain Signal Strength
      • Get D3 Demos
      • Learn Kiosk Mode
      • Block Status Bar API
      • Display Full-Screen API
      • Display Full Screen Android API
      • Disable Home Key
      • Capture Power Button API
      • Retrieve Terminal Info
      • Save Files Locally
      • Set Default Launcher
      • Get Firmware Version
      • Get Firmware&EMV Version
      • Implement TLSv1.3
      • Auto-Run Post-Install
      • Understand Secure Connections
      • Use AnyDesk
      • Export Database to SD
      • Migrate App to Q2Premium
      • Auto-Run App Post-Boot
      • Integrate Java SDK in Flutter
      • Call AIDL Interface
      • Connect wirelessly
      • Get POS SN
      • UPT development-related
      • Q3 PDA Terminal Barcode Scanner
    • Key Injection
      • Inject Test Keys Remotely
      • Understand DUKPT
      • Understand Master&Session Keys
      • Use TMK KeyLoader POS
      • Understand Remote Key Injection
      • Resolve Serial Timeout
      • Import TMK Error: 74496
    • PINPAD
      • PINPAD Configuration Summary
      • Customize PINPAD GUI
    • TMS/Wizarview
      • TMS Overview
      • TMS User Guide
      • Register Terminal to WizarView
      • Accept TMS File Downloads
      • Handle User Locked Status
      • Apply WizarView Account
      • Batch Import Terminals
      • Unbind App Configuration
      • Remove App via TMS
      • Understand Agent Error Codes
      • Understand TMS IP Ports
      • Understand Update Scenarios
      • Understand App Binding Types
      • Apply RMA Maintenance Account
      • Update Firmware Remotely
      • Push APK to Specific Device
      • Set Agent Working Mode
      • Manage APK Prompt Installation
      • Network Control in Agent
      • Push Apps Using Tags
      • Deploy AID/CAPK via TMS
    • EMV
      • What's Tag91
      • What's CAPK
      • Set Issuer Scripts
      • Resolve Detection Priority Conflict
  • Wizarview Open API
Powered by GitBook
On this page
  • Error Format Overview
  • Error Prefix Explanation
  • Module code
  • Error code
  • Common error codes
  1. FAQ
  2. TMS/Wizarview

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.

PreviousRemove App via TMSNextUnderstand TMS IP Ports

Last updated 1 year ago