CPoC/ MPoC SDK - MineSec Developer Docs

Error code - SDK

Name	Type	Value	Description	Extra
SUCCESS	GENERIC	0	Operation/ process successful
MHD_SDK_NOT_AVAILABLE	SDK	987136	SDK is not registered successfully due to failed attestation or in-secure runtime	SDK is not registered successfully. You should call init function to re-registered If this name returns suddenly in API calling. it means SDK attestation status is not in a secure status (SECURITY_FLAW or UNDER_ATTACKING), you can invoke attestation API manually to get a secure attestation result to clean the status
MHD_SDK_LICENSE_INVALID	SDK	987137	License reading/ analysis fails	License is modified/ changed which makes license integrity validation fails
MHD_SDK_LICENSE_PATH_INVALID	SDK	987138	Invalid license path	License name is incorrect No license
MHD_SDK_LICENSE_EXPIRED	SDK	987139	Expired license	Please contact MineSec support to renew the license file
MHD_SDK_INIT_EMVFAIL	SDK	987140	EMV Kernel Initialization fails	Reason to be added
MHD_SDK_INIT_STORAGEFAIL	SDK	987141	SDK init keystone file encryption fails
MHD_SDK_NOT_INITIALIZED	GENERIC	987142	SDK is not initialized yet, please do initialize first.	SDK is under attacking. All critical credentials are removed, and the SDK status is reset to uninitialized status
MHD_SDK_JNI_OBJECT_NULL	GENERIC	987143	Input parameter null	the application obfuscation impacts the API input parameters which removes some parameter due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening
MHD_SDK_JNI_ARRAY_NULL	GENERIC	987144	Input array parameter null	the application obfuscation impacts the API input parameters which removes some parameter due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_SDK_JNI_METHOD_NOTEXIST	GENERIC	987145	Java method not found, might due to application obfuscation causing some SDK’s API missing during the compiling	Please contact our support for the pro-guard rule For early versions, recommend to migrate to 1.10.105.12 or newer
MHD_SDK_JNI_CLASS_NOTEXIST	GENERIC	987146	Java class not found, might due to application obfuscation causing some SDK’s API missing during the compiling	Please contact our support for the pro-guard rule. This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_SDK_JNI_CLASS_EXCEPTION	GENERIC	987147	JNI exception	JNI issue - this rarely happens after 1.10.105.11 For early versions, recommend to migrate to 1.10.105.12 or newer
MHD_SDK_INIT_MEMORY_ERROR	GENERIC	987152	[Deprecated since 1.10.105.12+] SDK security memory initialization fails	SDK init security data storage fails. This usually happens due to encrypted shared-reference fails or key store unusual exceptions This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_INIT_DEVICE_ERROR	GENERIC	987168	[Deprecated since 1.10.105.12+] This device can not be profiled	CyWall Initialization fails due to device security check This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_NETWORK_TIMEOUT	SDK	987170	[Deprecated since 1.10.105.12+] SDK connection timeout	CyWall Initialization fails due to network connection fails This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_NETWORK_ERROR	SDK	987171	[Deprecated since 1.10.105.12+] Remote server name	CyWall Initialization fails due to network connection names This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_NETWORK_SERVER_NOTAVAILABLE	SDK	987172	[Deprecated since 1.10.105.12+] Remote server is not available	CyWall Initialization fails due to network server internal names This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_NETWORK_SERVER_ERRORRESPONSE	SDK	987173	[Deprecated since 1.10.105.12+] Remote server name	CyWall Initialization fails due to network server name response This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_RANDOM_SEEDING_FAIL	SDK	987174	SDK random number seeding fails	Random number seeding fails due to fails reading random number from remote cloudHSM server. it has to be retried again. This name code has been removed from SDK after 1.10.105.12. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer Might also due to DNS issue, please contact support
MHD_SDK_SECURITY_GENERAL_ERROR	SDK	987175	[Deprecated since 1.10.105.12+] SDK security core general name	CyWall Initialization fails due to unknown general names This name code has been removed from SDK after 1.10.105.12. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_SECURITY_PARAMETERS_ERROR	SDK	987176	[Deprecated since 1.10.105.12+] SDK security parameters name	Get CyWall identifier fails due to invalid parameter setting. This happens during CyWall initialization This name code has been removed from SDK after 1.10.105.12. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer
MHD_SDK_SECURITY_NOT_REGISTERED	SDK	987177	[Deprecated since 1.10.105.12+] SDK secure core is not registered	SDK registration process fails. This may happens the device and application are not compliance with the AM server cots baseline OR the network communication between SDK and backend fails You should retry the registration process by calling init function contact support if this continuously happens as this may be caused by non-compliance with AM Cots-Baseline
MHD_SDK_SECURITY_NOT_INITIALIZED	SDK	987178	SDK secure core initialization fails	SDK is under attacking. all critical credentials are removed, and the SDK status is reset to uninitialized status. please re-init the SDK This is the same as MHD_SDK_NOT_INITIALIZED
MHD_GENERAL_ERROR	GENERIC	987391	General unknown name	Native functions registration fails Java execution flow throws an exception which are not expected Security storage exception Cryptographic operation exception Please contact support for log checking & investigation
MHD_SDK_INVALID_PARAMETER	GENERIC	991232	Input parameters are invalid	Reading invalid data / cryptographic sensitive parameters from security storage Reading invalid EMV parameters from local storage Input data can’t be transformed to recognized format. For example. A hex string can NOT to converted to byte array due to the length
MHD_SDK_LICENSE_FAILEDOPEN	LICENSE	987175	Fails to open license file	IO Exception happens during license file reading. This rarely happens but you should retry init again when this name happens
MHD_STORAGE_ERR_KEY_NOTFOUND	SDK	999425	Cryptographic key is not found	key is not found from security key database. This may occur due to provide an incorrect key name OR the key is removed if attestation result is UNDER_ATTACKING. if the key is the payment keys that are injected by application developer. try to re-inject the key to resolve this issue. if the key is managed by SDK itself. try to clean the application data cache and reinitialize the SDK.
MHD_STORAGE_ERR_DEIVCE_UNMATCH	SDK	999427	Device clone attack	Please contact support or you can also uninstall the application and reinstall application to eliminate the issue.
MHD_KMS_KEY_READ_ERROR	KMS	1016065	Reading key name due to not found or be modified	SDK is under insecure attestation status, which blocks the cryptographic key reading operation. please check the attestation status of the SDK. key content is compromised. it can not be recovered by SDK. this can be only resolved by re-inject the key. key transformation fails as the content can not be transformed to a recognized key block. this can be only resolved by re-inject the key.
MHD_KMS_NOTSUPPORTED_TR31	KMS	1016066	TR31 package is not supported	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_INCORRECT_TR31HEADER	KMS	1016067	TR31 header is invalid	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_INCORRECT_MAC	KMS	1016068	TR31 mac result is invalid	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_INCORRECT_ENCRYPT	KMS	1016069	Encryption fails	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_INCORRECT_KEYSIZE	KMS	1016072	Invalid key size	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_KEY_ENCODED_ERROR	KMS	1016081	Invalid key encoding	The key reading from security crypto database is not recognized as the format/encoding is not expected. Re-inject key can resolve this issue.
MHD_KMS_KEY_TYPE_ERROR	KMS	1016082	Key type (key usage) and value unmatched	The key reading from security crypto database is not accepted as the key type is NOT correct. The name also occurs if a wrong key type is provided when doing key derivation. (for example: DUKPT IK AES-128 can only generate AES-128 working key or TDES working key. it can’t generate AES-256 key)
MHD_KMS_KEY_RSA_PARSEERROR	KMS	1016083	RSA key parsing name	RSA key parsing from PEM file OR from E,D,N big integer fails. OR provided PEM file is not a correct key. (example: provide private key PEM as public key PEM)
MHD_EMV_KERNEL_NOT_AVAILABLE	EMV	1020160	No matching EMV Kernel could be found	The EMV kernel initialization fails The EMV kernel does not support the AID parameters due to the EMV Card scheme supporting setting by license file.
MHD_EMV_NFC_PERMISSION_MISS	EMV	1020161	Missing NFC permission
MHD_EMV_NFC_CAMERA_PERMISSION_MISS	EMV	1020162	Missing camera permission
MHD_EMV_NFC_NETWORK_UNCONNECTTED	EMV	1020163	Network is not connected
MHD_EMV_NFC_DISABLED	EMV	1020164	NFC is disabled
MHD_EMV_ADB_ENABLED	EMV	1020165	ADB is enabled
MHD_EMV_SIDE_LOADED	EMV	1020166	Side loaded
ERR_UNKNOWN_CODE	GENERIC	99999	Unknown name	native functions registration fails java execution flow throws an exception which are not expected security storage exception cryptographic operation exception for this issue, it should contact support for checking the logging in behind.
MHD_SDK_REGISTRED	SDK	0	SDK registered
MHD_SDK_NETWORK_TIMEOUT	SDK	196616	Network connection timeout
MHD_SDK_LICENSE_ABOUT_TO_EXPIRE	SDK	131079	[Deprecated since 1.10.105.12+] Initialization fails due to network server name response	CyWall license is going to be expired This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_CLIENT_CERTIFICATE_EXPIRED	SDK	131080	Client certificate has expired	The client certificate has expired, so re-registration is not possible anymore. A new registration needs to be carried out.
MHD_SDK_ALREADY_REGISTERED	SDK	131081	SDK already registered
MHD_SDK_NOT_REGISTERED	SDK	131082	SDK not registered	you are invoking SDK APIs without SDK being registered successfully. please register it successfully prior to calling those APIs
MHD_GENERAL_ERROR	SDK	987391	Unknown name	native functions registration fails java execution flow throws an exception which are not expected. security storage exception cryptographic operation exception for this issue, it should contact support for checking the logging in behind.
MHD_SDK_STORAGE_DEVICE_MISMATCH	SDK	327685	Application instance does not match the device	device clone attacking. in this case, please contact with solution provider or support. you can also uninstall the application and reinstall application to eliminate the issue.
MHD_SDK_INVALID_SERVER_RESPONSE	SDK	983045	[Deprecated since 1.10.105.12+] Initialization fails due to network server name response	This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_INVALID_PARAMETER	SDK	991232	Invalid parameters	reading invalid data / cryptographic sensitive parameters from security storage reading invalid EMV parameters from local storage input data can’t be transformed to recognized format. (for example. A hex string can NOT to converted to byte array due to the length of
MHD_SDK_INIT_FAIL	SDK	987136	[Deprecated since 1.10.105.12+] Invalid SDK status	SDK initialization fails due to invalid status in SdkCurrentStatus in SDK_CONTEXT This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_SEC_FAIL	SDK	987137	[Deprecated since 1.10.105.12+] Security of SDK is impacted by some attacks	One status in SdkCurrentStatus in SDK_CONTEXT failed This means security of SDK is impacted by some attacks This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_REGISTRATION_FAIL	SDK	987138	[Deprecated since 1.10.105.12+] SDK is not registered	SDK is not registered. SDK will not work under this status. This name code has been removed from SDK after 1.10.105. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_LICENSE_EXPIRED	SDK	987139	[Deprecated since 1.10.105.12+] SDK license is expired	SDK license is expired. SDK will not work under this status This name code has been removed from SDK after 1.10.105.12 (no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_SDK_EMV_INIT_FAIL	SDK	987140	EMV kernel initialization fails. please try re-init again.
MHD_SDK_STORAGE_INIT_FAIL	SDK	987141	Storage initialization fails. please try re-init again
MHD_SDK_NOT_AVAILABLE	SDK	987142	SDK internal warning due to not registered or expired license	SDK latest attestation result is not “HEALTH” status. retry or re-open application to clean the status. SDK is under “block” status. contact service admin to unblock this SDK
MHD_SDK_OBJECT_NULL	SDK	987143	SDK internal warn of object not existing	Input parameters are NULL the application obfuscation impacts the API input parameters which removes some parameter due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening
MHD_SDK_ARRAY_NULL	SDK	987144	SDK internal warn of array is not available	Input parameters are NULL the application obfuscation impacts the API input parameters which removes some parameter due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening
MHD_SDK_METHOD_NOTEXIST	SDK	987145	[Deprecated since 1.10.105.11+] SDK internal warn that method is not available	SDK internal warn that method is not available the application obfuscation impacts the API definitions which removes some API methods due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_SDK_CLASS_NOTEXIST	SDK	987146	[Deprecated since 1.10.105.11+] SDK internal warn that class is not available	the application obfuscation impacts the API definitions which removes some API methods due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_SDK_JCLASS_EXCEPTION	SDK	987147	[Deprecated since 1.10.105.11+] SDK internal warn java class exceptions	the application obfuscation impacts the API definitions which removes some API methods due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_SDK_BOOLEAN_NULL	SDK	987148	[Deprecated since 1.10.105.11+] SDK internal warn that boolean is not available	the application obfuscation impacts the API definitions which removes some API methods due to incorrect obfuscation rules. In this case, you should contact support for investigation. meanwhile, try to disable obfuscation to see if the issue is still happening This rarely happens after 1.10.105.11. For early versions, strongly recommend to migrate to 1.10.105.12 or newer
MHD_KMS_INVALID_INPUT	KMS	1015808	KMS operation input parameters are invalid	key loading parameters are incorrect.(providing RSA wrapped key block for TR31 key injection) cipher operation. (for example: using a AES Key to do TDES operation. or signing data using encryption key)
MHD_KMS_RSA_GENKEYERR	KMS	1015809	KMS mbedtls RSA key generation fails during registration stage	It happens usually due to the insufficient random numbers OR memory management. Retry the API will usually resolve it.
MHD_KMS_RSA_EXPORTERR	KMS	1015810	KMS RSA key exporting fails during registration stage	It happens usually due to the insufficient random numbers OR memory management. Retry the API will usually resolve it.
MHD_KMS_RSA_INCORRECT_PARAMETER_HEXSIZE	KMS	1015811	RSA Key size name, it must be 2048-bit or above, and hex string should be 2*N in length
MHD_KMS_READ_PKERR	KMS	1015812	KMS read RSA public key from security key store fails	it happens due to key is compromised
MHD_KMS_READ_SKERR	KMS	1015813	KMS read RSA private key from security key store fails	it happens due to key is compromised
MHD_KMS_KEY_NOT_EXIST	KMS	1015814	Key can’t be found in crypto database
MHD_KMS_KEY_NOT_CORRECT	KMS	1015815	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_AES_KEYSIZE_ERR	KMS	1015816	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_AES_INCORRECT_IV	KMS	1015817	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_AES_CIPHERMODE_NOTFOUND	KMS	1015818	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_OUTPUT_BUFFER_TOO_SMALLER	KMS	1015819	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_AES_MODE_ERROR	KMS	1015820	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_KEYNAME_NOTALLOWED	KMS	1016064	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12(no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_KEY_READ_ERROR	KMS	1016065	SDK is under insecure attestation status, which blocks the cryptographic key reading operation. please check the attestation status of the SDK	key content is compromised. it can not be recovered by SDK. this can be only resolved by re-inject the key. key transformation fails as the content can not be transformed to a recognized key block. this can be only resolved by re-inject the key.
MHD_KMS_NOTSUPPORTED_TR31	KMS	1016066	TR31 key block is not supported by SDK	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis
MHD_KMS_INCORRECT_TR31HEADER	KMS	1016067	TR31 key block validation fails	please check the user manual to understand the steps to inject a key with TR31 package if the issue continuously occurs, please contact support and provide the TR31 key block for analysis.
MHD_KMS_INCORRECT_MAC	KMS	1016068	TR31 package Mac verification fails	This may happen when TR31 package is not correctly delivered or generated
MHD_KMS_INCORRECT_ENCRYPT	KMS	1016069	Encryption process failed	AES GCM operation fails (tag check fails) DUKPT Key generation fails (counter exceeds) crypto operation mode incorrect(it is neither CIPHER_ENCRYPT nor CIPHER_DECRYPT)
MHD_KMS_INCORRECT_PAYLOAD	KMS	1016070	Deprecated since 1.10.105.12+	This name code has been removed from SDK after 1.10.105.12 (no expiration date). for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_KMS_TR31PARSE_ERROR	KMS	1016071	Fails to parse TR31 package	TR31 package is incomplete OR TR31 format is not supported (key binding method). Please contact support
MHD_KMS_INCORRECT_KEYSIZE	KMS	1016072	Key size is in correct	E.g. provide a AES key array with key size exceeds 256 bits. AES max key size 256 please check your key management solution
MHD_AST_ERR_PK_GEN_FAIL	KMS	995329	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CSR_GEN_FAIL	KMS	995330	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_PK_NE_GEN_FAIL	KMS	995331	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CURLE_COULDNT_RESOLVE_HOST_FAIL	KMS	995334	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CURLE_COULDNT_CONNECT_FAIL	KMS	995335	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CURLE_OPERATION_TIMEDOUT_FAIL	KMS	995356	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CURLE_SSL_CONNECT_ERROR_FAIL	KMS	995363	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.
MHD_AST_ERR_CURLE_DRBG_SEEDINGFAIL	KMS	995585	Deprecated since 1.10.105.11+	This name code has been removed from SDK after 1.10.105.11. for early versions, it is strongly recommended to migrate to 1.10.105.12 or newer.

EMV/ Kernel