Error Codes

The errors listed below are returned directly through the LiveData object as the transaction progresses through various statuses, from terminal activation to approval or decline returned by the acquirer. Different ViewData instances will be emitted to this object, each representing a specific type of error. Some error types, such as INTERNAL_ERROR, may include additional subtypes. However, most errors do not have subtypes. You can find the most common errors listed below, along with immediate responses and recommended next actions to mitigate the issues encountered.

ViewData	ErrorClass	ErrorCode	ProbablyReason	Action1
TerminalSessionCreatedErrorViewData	NFC_ERROR	10	Device doesn't have NFC or it is disabled	Check device specs and ask to enable NFC capability
TerminalSessionCreatedErrorViewData	DEVICE_STATE_FAILURE	15	App Credentials doesn't match between First Tech / MPP and Customer App (Google Play Data)	Check VersionCode, Package Name, Version Name inside App Config and Check SHA-256 generated by Google Play. One of them is not correct or registered in FT/MPP environment. Collect information and send to First Tech to analyze
TerminalSessionCreatedErrorViewData	INTERNAL_ERROR	18	ACTIVITY_NOT_AVAILABLE Exception. The Activity in charge to perform SDK actions stopped to working inside Android by user actions or other appications	Close and open the app (try again)
TerminalSessionCreatedErrorViewData	INTERNAL_ERROR	20	INVALID_SESSION_TIMEOUT Exception. Session time is taking longer than 180s	Check device time setting, make sure it's synced with network time and try again. TTP can't work with manual clock settings
TerminalSessionCreatedErrorViewData	INTERNAL_ERROR	21	ACTIVATION_WHILE_TRANSACTION_IN_FLIGHT Exception. Android Clock miss the parameters to handle the transaction	Check device time setting, make sure it's synced with network time and try again. TTP can't work with manual clock settings
TerminalSessionCreatedErrorViewData	INTERNAL_ERROR	1033	AUTHENTICATION_ERROR_AUTHORIZATION_GRANT_NOT_PRESENT Exception. It was caused because Scope, sdk_Client_Id or sdk_Client_Secret was invalid between First Tech and MPP	Collect information and send to First Tech to analyze
TerminalPaymentErrorViewData	INTERNAL_ERROR	1069	HTTP_NETWORK_HANDLE_TRANSACTION_RESPONSE_ERROR Exception. FT Back-End found an error while retrieving information from servers	It can be caused by an specific delay. Ask the user to try again. If it insists collect information and send to First Tech to analyze
TerminalPaymentErrorViewData	DISCOVERY_TIMEOUT	N/A	Card/Digital Wallet was not read in the less 30 seconds	Try again using the same card. Ask the user if they’re aware of the correct location of the NFC reading area on the device. If the error persists, try using a different card of change the device.
TerminalPaymentErrorViewData	MICROPHONE_USAGE_DETECTED	N/A	Terminal microphone is being used by another application during the use of the TTP app	Close all the apps and check if the current is not opened twice. Try to run the app again