Error Handling

The errors that occur inside the library are returned to the caller via the Error class. Errors can be parsed with the code variable, and the description of the error returns with the message variable. Throwable variable contains the details of the error. The throwable must not be shown to the end user at any point.

Error Data

data class Error (
    val code: Int? = null
    val message: String? = null
    val throwable: Throwable? = null
)

Error Codes

Names	Codes	Descriptions	Actions
STOPPED	98	Transaction can be stopped for some reason.	Show a general error message to the user.
ERROR_OTHER_CARD	99	The transaction is declined because it can not read the card correctly.	Show a general error message to the user.
UNEXPECTED_ERROR	100	SDK can not handle error.	Show a thrown error message to the user. Please contact Prophius Technical Team for the detail investigation.
KEYSTORE_NOT_INITIALIZED	102	Android Keystore could not be initialized.	Show a thrown error message to the user. User should change the device.
KEYSTORE_KEYS_NOT_CREATED	103	Android Keystore keys could not be created.	Show a thrown error message to the user. If the user continues to receive the same error, user should try again, and user should contact Prophius Technical Team.
NOT_BE_ENCRYPTED	104	Plaintext cloud not be encrypted.	Show a thrown error message to the user. Please delete device’s local storage and then reinitialize the SDK. if some error is occurred, device is attested.
NOT_BE_DECRYPTED	105	Cipher text cloud not be decrypted.	Show a thrown error message to the user. Please delete device’s local storage and reinitialize the SDK. if some error is occurred, device is attested.
NOT_BE_SIGNED	106	Message cloud not be signed.	Show a thrown error message to the user. If the user continues to receive the same error, user should try again, and user should contact Prophius Technical Team.
NOT_BE_VERIFIED	107	Hash value cloud not be verified.	Show a thrown error message to the user. If the user continues to receive the same error, user should try again, and user should contact Prophius Technical Team.
CONNECTION_ERROR	108	Network connection could not be established.	Please check the device's internet connection.
NOT_SECURE_DEVICE	109	Device could not be secured. Security vulnerabilities detected on the device.	Please contact Prophius Technical Team for the detail investigation.
PUBLIC_KEY_NOT_GOT	111	RSA Keypair could not be generated.	Show a thrown error message to the user. If the user continues to receive the same error, user should try again.
SSL_CERTIFICATE_NOT_VERIFIED	112	SSL Certificate could not be verified.	Please contact Prophius Technical Team for the detail investigation.
SSL_CERTIFICATE_NOT_SUPPORTED	113	SSL Certificate could not be supported.	Please contact Prophius Technical Team for the detail investigation.
GOOGLE_PLAY_SERVICE_UPDATE_ERROR	115	Device does not have the updated Google Play Service version.	User should update the Google Play Service.
GOOGLE_PLAY_SERVICE_TOKEN_ERROR	116	Google Play Service’s token could not be generated.	Please contact Prophius Technical Team for the detail investigation.
NFC_NOT_SUPPORTED	117	Device does not have NFC.	User should use the device that has NFC.
NFC_NOT_ENABLED	118	NFC is not enabled.	User should turn on the NFC.
PERMISSIONS_NOT_BEEN_GRANTED	119	Read_Phone_State and Call_Phone permissions could not be granted.	User should grant permissions.
ACCESSIBILITY_SERVICE_NOT_ENABLED	120	Accessibility service could not be enabled.	User should enable the accessibility service.
SIM_STATE_ABSENT	121	Device does not have the SIM. Thus USSD payment can not perform on this device.	User should use the device that has SIM.
USSD_CODE_NOT_EXIST	122	USSD code could not be defined for this merchant.	Please contact Prophius Technical Team for the detail investigation.
DATABASE_KEY_NOT_CREATED	123	Database key could not be created.	Show a thrown error message to the user. If the user continues to receive the same error, user should try again, and user should contact Prophius Technical Team.
NOT_INITIALIZED	127	Paycontactless Embed SDK is not initialized.	Call initialize function first. After getting the success response, the other functions of the SDK can be called.