# Error Code Table

Status Code Meaning Scenarios Where This Error Occurs
9000 Unknown Error Default value, generally does not occur
9001 (Android) Operation Canceled Occurs when inter-process navigation is involved in Android and the operation is canceled
9002 Invalid Parameter Required parameters are missing or incorrect parameter types are passed when calling an API
10000 SDK Initialization Failed SDK initialization fails due to incorrect parameters such as SDKKey passed during SDK initialization
10001 Network Not Connected Occurs when the device's network is abnormal and cannot access the network
10002 SDK Configuration Information is Empty After SDK initialization, asynchronous SDK configuration information retrieval fails, and retrying to retrieve configuration information when opening a Mini-Program also fails
10003 Device Type Not Currently Supported Unsupported device type; configuration information indicates supported device types, e.g., only Android devices are allowed but the actual device is iOS
10004 Current Available Device Limit Reached IoT scenarios, e.g., the license configured in the Management Console allows 10,000 devices, but the actual number of running devices exceeds 10,000
10005 License Domain Verification Failed The server used when opening the Mini-Program is not in the domain list returned by the SDK configuration information
10006 (Android) Current Device System Version Too Low, Cannot Open Mini-Program The Android device system version is too low (systems below Android 4.4 are not supported; this is a compatibility check logic)
10007 QR Code Format Invalid QR code content is not in a FinClip-supported format, indicating it is not a FinClip Mini-Program QR code
10008 QR Code Environment Mismatch with SDK Initialization Environment The server used when opening the Mini-Program via QR code is not in the server list used during SDK initialization
11000 Invalid appId appId is not passed when calling the API to open a Mini-Program
11001 SDK Key Does Not Support Opening Offline Mini-Programs The SDKKey used does not support offline Mini-Programs
11002 Current Mini-Program Environment Mismatch with SDK Initialization Environment SDK initialization servers are A, B, C, but the server used to open the Mini-Program is D
11003 QR Code Encryption Information is Empty Likely a backend error resulting in a 200 response but empty encryption information (compatibility check logic, generally does not occur)
11004 Decrypted QR Code Information is Empty After requesting the backend interface with QR code information, the returned encrypted information cannot be decrypted (compatibility check logic, generally does not occur)
11005 QR Code Data Type Error After requesting the backend with QR code information, the decrypted data format is not key-value pairs (needs to be convertible to NSDictionary in iOS, JSON object in Android; compatibility check logic, generally does not occur)
11006 Missing Type in QR Code The QR code return information does not contain the Mini-Program version type (compatibility check logic, generally does not occur)
11007 Unknown Mini-Program Type in QR Code The version type in the QR code return information is unsupported (supported types: release, trial, temporary, review, development, remoteDebug)
11008 Invalid codeId The QR code corresponding information lacks codeId (compatibility check logic, generally does not occur)
11009 Mini-Program Already Running (Mini-Program Startup Debouncing) Opening the same Mini-Program multiple times frequently
11010 (Android) Preloaded Base Library File Does Not Exist When opening an online Mini-Program, the offline base library path is configured but the file does not exist
11011 (Android) Preloaded Mini-Program File Does Not Exist When opening an online Mini-Program, the offline Mini-Program package path is configured but the file does not exist
11012 SDK Not Initialized Calling SDK APIs without initializing the SDK or after initialization failed
12000 Network Exception, Cannot Connect to Server HTTP error occurs during SDK-backend server communication
12001 Service Exception, Interface Request Failed (Generic) SDK request to backend service interface fails (default when no specific business error code matches)
12002 Server Returned Data Exception (Generic) SDK request to backend service interface returns incorrect parameter types
12003 Service Exception, Mini-Program Details Interface Request Failed SDK request to Mini-Program details interface fails, default when no business error code matches
12004 Service Exception, Base Library Details Interface Request Failed SDK request to base library details interface fails, default when no business error code matches
12005 Batch Query Mini-Program Details Interface Request Failed SDK request to batch query Mini-Program details interface fails
12006 Service Exception, Mini-Program Details Interface Returned Data Decryption Error SDK request to Mini-Program details interface, returned data decryption fails
12007 Service Exception, Base Library Details Interface Returned Data Decryption Error SDK request to base library details interface, returned data decryption fails
12008 Service Exception, Interface Returned Data Decryption Error (Generic) SDK request to other backend interfaces, returned data decryption fails
12009 Service Exception, Mini-Program Details Interface Returned Data Exception SDK request to Mini-Program details interface, returned data type is incorrect
12010 Service Exception, Base Library Details Interface Returned Data Exception SDK request to base library details interface, returned data type is incorrect
12011 Batch Query Mini-Program Details Interface Returned Data Exception SDK request to batch query Mini-Program details interface, returned data type is incorrect
12012 Mini-Program Full Package Download URL is Empty, Cannot Download When opening a full package Mini-Program, the full package download URL returned by the Mini-Program details interface is empty
12013 Mini-Program Subpackage Download URL is Empty, Cannot Download When opening a subpackage Mini-Program, the subpackage download URL returned by the Mini-Program details interface is empty
12014 (Android) Mini-Program Subpackage File Name Invalid When opening a subpackage Mini-Program, the subpackage file name in the Mini-Program details interface is empty
12015 Base Library Download URL is Empty, Cannot Download The download URL in the data returned by the base library details interface is empty
12016 Base Library Version Number is Empty The version number in the data returned by the base library details interface is empty
12017 Mini-Program Subpackage File Download Failed Downloading Mini-Program subpackage file fails
12018 Mini-Program Full Package File MD5 Verification Failed After downloading the Mini-Program full package file, MD5 verification fails
12019 Mini-Program Subpackage File MD5 Verification Failed After downloading the Mini-Program subpackage file, MD5 verification fails
12020 Base Library MD5 Verification Failed After downloading the base library file, MD5 verification fails
12021 (iOS) Download Directory Error, Cannot Download Failed to create the storage folder before downloading files on iOS
12022 Download Failed Default scenario when downloading other files fails
12023 Base Library Download Failed Downloading base library file fails
12024 Mini-Program Download Failed Downloading Mini-Program package fails
12025 (iOS) Mini-Program Archive Abnormal, Copy Failed After downloading the Mini-Program package, copying to the storage directory fails
13000 Full Package Mini-Program service.html Missing, Please Check if Code Package is Compiled When loading a full package Mini-Program, service.html is missing in the full package
13001 Page Does Not Exist A non-existent page in the Mini-Program is passed when starting the Mini-Program
13002 Domain Not Registered, Cannot Open The Mini-Program attempts to access a domain not registered in the backend
13003 Domain Blacklisted, Cannot Open The Mini-Program attempts to access a domain that has been added to the blacklist
13004 (Android) Mini-Program Full Package Extraction Failed Full package Mini-Program file extraction fails on Android
13005 (Android) Mini-Program Subpackage Extraction Failed Subpackage Mini-Program file extraction fails on Android
13006 Base Library Extraction Failed Base library extraction fails
13007 Copy Base Library Resources Failed Copying base library resources to the Runtime directory fails on iOS
13008 Copy Mini-Program Resources Failed Copying Mini-Program resources to the Runtime directory fails on iOS
13009 (Android) Base Library Loading Failed Base library loading times out on Android
13010 Service Loading Timeout Loading the service layer JavaScript times out
13011 Offline Mini-Program offlineMiniprogramZipPath is Empty When opening an offline Mini-Program, offlineMiniprogramZipPath is not set
13012 Offline Mini-Program offlineFrameworkZipPath is Empty When opening an offline Mini-Program, offlineFrameworkZipPath is not set
13013 Offline Base Library Extraction Failed Base library extraction fails when opening an offline Mini-Program
13014 (iOS) Offline Mini-Program Package Does Not Exist When opening an offline Mini-Program, the file corresponding to the offline Mini-Program path does not exist
13015 (Android) Offline Mini-Program Path is Empty Path is empty when loading the Mini-Program package internally on Android
13016 Offline Mini-Program Extraction Failed Offline Mini-Program package extraction fails
13017 (Android) Offline Mini-Program Failed to Read package.json Failed to read package.json when opening an offline Mini-Program on Android
13018 (Android) offlinePackageFactoryClass Not Set Offline Mini-Program package proxy class is not set
13019 (Android) Subpackage File Obtained from Host-App is Empty The offline Mini-Program subpackage file obtained from the Host-App is empty on Android
13020 (Android) Failed to Get Local Subpackage File Failed to read the offline Mini-Program subpackage file from local storage on Android
13021 (Android) LocalInterfaceAppletHandler Not Set The LocalInterfaceAppletHandler proxy for the offline Mini-Program is not set
13022 Mini-Program Specified by appletId Not Found When calling functional APIs, the corresponding Mini-Program is not found via appletId
13023 (iOS) Foreground Running Mini-Program Not Found No foreground running Mini-Program is found (when native code calls H5 methods)
13024 Mini-Program Console Not Ready When the Host-App writes logs to the Mini-Program vConsole, the vConsole has not been created yet
13025 (Android) Mini-Program Information is Empty Some fault-tolerant checks within the SDK
13026 (iOS) File Name Error File name error on iOS
13027 (iOS) Base Library Folder Abnormal, Save Failed Failed to save the offline Mini-Program's base library to the storage directory due to abnormal folder
13028 (iOS) Mini-Program Folder Abnormal, Save Failed Failed to save the offline Mini-Program to the storage directory due to abnormal folder
13029 (Android) Thread Pool Exception When Executing Base Library Information Retrieval Task Compatibility check, exception capture
13030 (Android) Thread Pool Exception When Executing Mini-Program Package Retrieval Task Compatibility check, exception capture
13031 (Android) Screenshot Failed Failed to generate screenshot on Android, e.g., when sharing or forwarding a Mini-Program
13032 (Android) Specified Mini-Program Process Not Found Failed to find the Mini-Program process with the specified ID on Android, e.g., when navigating back to the Mini-Program process
13033 (Android) Subpackage Files Missing After Extraction, Integrity Verification Failed When loading a Mini-Program, verifying the integrity of extracted subpackage files fails to prevent incomplete files due to app termination during extraction
13034 (Android) Subpackage Integrity Verification Error Error occurred during integrity check of extracted files
13035 (iOS) Extraction Directory is Empty The directory used to store Mini-Program extracted files does not exist on iOS
20000 Backend Interface Returned, Mini-Program Does Not Exist Backend cannot find the Mini-Program corresponding to appId, usually due to Mini-Program ID and server mismatch, e.g., test environment appId with production server address
20001 Backend Interface Returned, Mini-Program Has Been Taken Offline The Mini-Program to be opened has been taken offline in the Management Platform; check status in Management Console
20002 Backend Interface Returned, Mini-Program Has Expired The Mini-Program to be opened has expired; check status in Management Console
20003 Backend Interface Returned, Mini-Program Is Disabled The Mini-Program is disabled; check status in Management Console
20004 Backend Interface Returned, Application Not Registered on Platform The Host-App is not registered in the Management Platform, usually due to SDKKey and server mismatch
20005 Backend Interface Returned, Application Cooperation Terminated The application's cooperation with the Mini-Program has been terminated; check the association status in Management Platform
20006 Backend Interface Returned, Mini-Program and Application Not Associated appId finds a Mini-Program in the backend, but the Mini-Program is not associated with any Host-App
20007 Backend Interface Returned, bundleId Is Disabled The Host-App corresponding to the SDK Key is disabled; check application status in Management Platform
20008 Backend Interface Returned, Application Has Expired The Host-App has expired in the backend
20009 Backend Interface Returned, Mini-Program's Enterprise Account Status Abnormal The enterprise account owning the appId has an abnormal status; check by logging into Management Platform
20010 Backend Interface Returned, Backend Configured License Abnormal The license corresponding to the server is abnormal, preventing normal backend interface access
20011 Backend Interface Returned, Corresponding Mini-Program Version Information Not Found Error when unable to match version details for the AppId
20012 Backend Interface Returned, Database Error Management Platform database error
20013 Backend Interface Returned, Enterprise Status Abnormal Failed to retrieve the enterprise corresponding to appId
20014 Backend Interface Returned, SDKKey Does Not Belong to Current Server sdkKey information cannot be found in Management Console query, possibly due to incorrect sdkKey or server
20015 Backend Interface Returned, Insufficient Resources Backend interface call count or download traffic quota exhausted, typically for SaaS users
20016 Backend Interface Returned, Search Function Disabled, Cannot Search The license configuration item for the search interface is not enabled, so search functionality cannot be called
20017 Backend Interface Returned, Image Upload Failed Failed to upload the generated image when sharing a Mini-Program
20018 Backend Interface Returned, QR Code Has Expired The QR code has expired
20019 Backend Interface Returned, No Permission to Get Mini-Program List (Specific to Management Mini-Program Getting List) No permission to retrieve Mini-Program list; in private deployments, only configured management Mini-Programs can get the list
20020 Backend Interface Returned, Privacy Agreement Information Does Not Exist When calling the Mini-Program privacy configuration interface, the corresponding privacy agreement is not found
20021 Backend Interface Returned, Invalid Request Parameter, sdkkey Does Not Exist sdkkey is not passed in the request header when calling the backend interface
20022 Backend Interface Returned, Backend Failed to Parse Request Parameters Backend failed to parse interface parameters
20023 Backend Interface Returned, Internal Service Interface Exception Internal backend service error
20024 Backend Interface Returned, No Available Base Library Version for Current SDK Management Console has not uploaded the base library compatible with the SDK
20025 Backend Interface Returned, SDK Fingerprint Verification Failed SDK fingerprint verification failed in the certificate-linked environment
20026 Backend Interface Returned, Abnormal Parameters When Getting Base Library Information Parameters are incorrect or backend cannot parse correctly when calling the base library information interface
20027 Backend Interface Returned, SDK Version Number Format Error SDK version number is incorrect; very old backends do not support x.y.z-xxx format version numbers
20028 Backend Interface Returned, Base Library Database Error Database error when querying base library information
20029 Backend Interface Returned, Current User Has No Trial Permission When opening a trial version Mini-Program, the current user's userId is not added to the trial user list
20030 Backend Interface Returned, Current User Has No Trial Permission When opening a trial version Mini-Program, the current user's userId is not added to the trial user list
20031 Backend Interface Returned, Trial Version Has Been Canceled The Mini-Program's trial version has been canceled
20032 Backend Interface Returned, Current User Has No Development Permission When opening a development version Mini-Program, the current user's userId is not added to the development user list
20033 Backend Interface Returned, Current User Has No Review Permission When opening a review version Mini-Program, the current user's userId is not in the reviewer list
20034 Backend Interface Returned, SDK Key Invalid The application corresponding to the sdk key is not the management Mini-Program appId
20035 Backend Interface Returned, System Internal Call Error Management Platform system internal error
20036 Backend Interface Returned, Failed to Get Domain Information Management Platform failed to retrieve the Mini-Program's domain information
29999 Backend Interface Returned, Service Unavailable Management Platform service exception
© FinClip with ❤ , Since 2017