menu

Payment API

What's on this page

In-person Payments / SoftPOS / General / SoftPOS Errors

Installation errors

General Error Code General Error Message Detailed Error Code Detailed Error Message (Code) Error Reason / How to solve
10000 SOFTPOS_NOT_INSTALLED Install SoftPOS application from Play Store
11000 SOFTPOS_NOT_INSTALLED Install SoftPOS application from Play Store
12000 SOFTPOS_NOT_INSTALLED Install SoftPOS application from Play Store
10001 NFC_NOT_SUPPORTED Device is not NFC compatible
11008 NFC_NOT_SUPPORTED Device is not NFC compatible
10002 DEV_OPTIONS_ENABLED Disable Developer option on Device
Via Settings → System/Additional Settings → Developer options → Disable
11009 DEV_OPTIONS_ENABLED Disable Developer option on Device
Via Settings → System/Additional Settings → Developer options → Disable
11004 NETWORK_ERROR 10000 NETWORK_CONNECTION_ERROR Check if device has a network connection
12003 NETWORK_ERROR 20000 NETWORK_ERROR Check if device has a network connection
NETWORK_ERROR 30000 NETWORK_ERROR Check if device has a network connection
11005
12004		 DEVICE_STATE_FAILURE 10001
20001
30001		 DEVICE_STATE_FAILURE
DEVICE_STATE_FAILURE
SESSION_CONFIG_ERROR		 Contact support
11006 NFC_NOT_ENABLED_ERROR 20002 NFC_ERROR Check if nfc is enabled on the device
12005 NFC_ERROR 20002 NFC_ERROR Contact support
12002 TERMINAL_NOT_INSTALLED 50006 Reinstall terminal
10003 INTERNAL_ERROR 40000 SERVICE_BIND_FAILURE Contact support
11002 ACTIVATION_PAYLOAD_INVALID Contact support
11003 EMV_CONFIG_NOT_FOUND Contact support
11007 INTERNAL_ERROR 10002 INTERNAL_ERROR Contact support
10003 UNSUPPORTED_ANDROID_OS_VERSION Contact support
10004 TERMINAL_NOT_INITIALISED_YET Contact support
20003 DEACTIVATED Contact support
20004 CONFIGURATION_VALIDATION_HASH_FAILURE Contact support
20005 INTERNAL_ERROR Contact support
30001 GET_INSTALLATION_PAYLOAD_FAILURE Contact support
40000 SERVICE_BIND_FAILURE Contact support
40001 SERVICE_DISCONNECTED_FAILURE Contact support
40002 REMOTE_EXCEPTION Contact support
50000 CHECK_INSTALL_PRE_CONDITIONS_RESULT_FAILURE Contact support
50001 TERMINALL_INSTALL_RESULT_FAILURE Contact support
50008 TERMINALL_INSTALLATION_ID_IS_EMPTY Contact support
50009 INSTANCE_ID_CANNOT_BE_SET Contact support
50013 KEYPAIR_GENERATION_FAILED Contact support
50014 INIT_INTEGRITY_TOKEN_PROVIDER_FAILED Contact support
50015 GET_INTEGRITY_TOKEN_FAILED Contact support
50016 JWK_THUMBPRINT_FAILED Contact support
12006 INTERNAL_ERROR 10002 UNSUPPORTED_ANDROID_OS_VERSION Contact support
10003 INTERNAL_ERROR Contact support
10004 TERMINAL_NOT_INITIALISED_YET Contact support
20003 DEACTIVATED Contact support
20004 CONFIGURATION_VALIDATION_HASH_FAILURE Contact support
20005 INTERNAL_ERROR Contact support
30001 GET_AUTHORIZATION_GRANT_FAILURE Contact support
40000 SERVICE_BIND_FAILURE Contact support
50002 CHECK_INIT_SESSION_PRE_CONDITIONS_RESULT_FAILURE Contact support
50003 INIT_SESSION_RESULT_FAILURE Contact support

transaction errors

General Error Code General Error Message Detailed Error Code Detailed Error Message (Code) Error Reason / How to solve
13000 Transaction Error 13000 SOFTPOS_NOT_INSTALLED Install softpos app
50007 SERVICE_DISCONNECTED_FAILURE Retry the transaction, if it still occurs contact support
50006 TERMINAL_NOT_INSTALLED Reinstall terminal
10000 NETWORK_CONNECTION_ERROR Check if the device has an internet connection
20000 NETWORK_ERROR Check if the device has an internet connection
31001 NETWORK_ERROR Check if the device has an internet connection
10001 DEVICE_STATE_FAILURE Contact support
20001 DEVICE_STATE_FAILURE Contact support
20002 NFC_ERROR Contact support
31017 NFC_ERROR Contact support
31015 NFC_NOT_ENABLED_ERROR Enable NFC on the device
31016 DEV_OPTIONS_ENABLED Disable Developer options on the device
31018 APP_IN_BACKGROUND Contact support
31002 MICROPHONE_USAGE_DETECTED Contact support
31003 CAMERA_USAGE_DETECTED Contact support
31004 EXTERNAL_CAMERA_DETECTED Contact support
31006 TOTAL_ELAPSED_TIMEOUT Retry transaction
31007 DISCOVERY_TIMEOUT Retry transaction
31008 PIN_ENTRY_ACCUMULATED_TIMEOUT Retry transaction
31009 PIN_ENTRY_TIMEOUT Retry transaction
31010 AUTHORIZATION_IN_PROGRESS_TIMEOUT Retry transaction
31012 PIN_PAD_OBSCURED_ERROR Retry transaction
31013 PIN_PAD_DETACHED_ERROR Retry transaction
50008 INVALID_AMOUNT Contact support
50009 INVALID_METHOD_TRANSACTION_ID Contact support
13001 Transaction Cancelled 30000 DEVICE_STATE_FAILURE Contact support
30001 TRANSACTION_WAS_TERMINATED Retry transaction
30002 USER_CANCELLED_PIN_PAD Retry transaction
30003 SESSION_DEACTIVATED Retry transaction
30004 TIME_CHECK_ERROR Retry transaction
13002 Transaction Not Authorized 32000 ONLINE_DECLINED Retry transaction
32001 OFFLINE_DECLINED Retry transaction
32002 INVALID_AUTHORISATION_DATA Retry transaction
32003 NO_CARD_APPLICATION Retry transaction
32004 NO_CARD_APPLICATION_SELECTOR_MISMATCHED Retry transaction
32005 PROCESSING_ERROR Retry transaction
32006 CARD_ERROR Retry transaction
13003 Internal Error 40000 SERVICE_BIND_FAILURE Contact support
40002 REMOTE_EXCEPTION Contact support
50004 CHECK_TRANSACTION_PRE_CONDITIONS_RESULT_FAILURE Contact support
50005 TRANSACTION_RESULT_FAILURE Contact support
50010 TRANSACTION_PAYLOAD_TRANSACTION_ID_LENGTH_VIOLATION Contact support
50011 TRANSACTION_PAYLOAD_CARD_ACCEPTOR_TERMINAL_IDENTIFIER_LENGTH_VIOLATION Contact support
50012 TRANSACTION_PAYLOAD_CANNOT_BE_RETRIEVED_FROM_BACKEND Contact support
50017 JWS_VERIFICATION_FAILED Contact support
50018 JWE_DECRYPTION_FAILED Contact support
50019 UNEXPECTED_ERROR Contact support
10002 UNSUPPORTED_ANDROID_OS_VERSION Contact support
10003 INTERNAL_ERROR Contact support
20005 INTERNAL_ERROR Contact support
31015 INTERNAL_ERROR Contact support
10004 TERMINAL_NOT_INITIALISED_YET Contact support
20003 DEACTIVATED Contact support
20004 CONFIGURATION_VALIDATION_HASH_FAILURE Contact support
31011 HOST_CALLBACK_ERROR Contact support
31014 PIN_PAD_LAUNCH_TIMEOUT Contact support
30005 TERMINAL_DISPOSED Contact support