Intent error codes

All codes in IntentErrorCode with default messages from IntentMessages where applicable. Errors return via alertError(IntentError) on your listener.

Error codeTypical message (IntentMessages)
APP_NOT_FOUNDPayment application is not installed
NO_INPUT_DATA_RECEIVED_VIA_INTENT(payment app)
INVALID_INPUT_DATA_RECEIVED_VIA_INTENT(payment app)
UN_AUTHORIZED_ACTION_TO_PAYMENT_APPThe requested intent request is not allowed to be processed
USER_LOGIN_CANCELLEDUser login process cancelled
TRANSACTION_LOOKUP_CANCELLEDTransaction lookup process cancelled
USER_CANCEL_TRANSACTIONThe transaction has been cancelled
NO_DATA_RECEIVED_FROM_PAYMENT_APPNo data received from payment app
PAYMENT_APP_CLOSED_BEFORE_RESPONSEPayment app closed or interrupted before returning a transaction result.
TERMINAL_NOT_SETUPPayment Link / QR is not configured on this terminal.
API_ERROR(varies)
INVALID_LIMITPlease enter a valid integer limit
INVALID_AMOUNTPlease enter valid amount between 0 and 999999
INVALID_TRANSACTION_IDPlease provide a valid transaction uuid to perform a refund / void
CODE_UNAUTHORIZED(payment app result)
CODE_ERRORInvalid input params (also generic)
CODE_RETRY(payment app result)
CODE_FALLBACK(payment app result)
CODE_SEE_PHONE(payment app result)
CODE_DECLINED(payment app result)
CODE_TIMEOUT(payment app result)
CODE_CANCELLEDTransaction cancelled (title helper)
CODE_TERMINATED(payment app result)
CODE_SERVER_ERROR(payment app result)
CODE_UNSUPPORTED(payment app result)
CODE_NETWORK_ERROR(payment app result)
INVALID_TRANSACTION_LOOKUP_PARAMInvalid transaction lookup parameters provided
INVALID_TERMINAL_DATE_TIME_ZONEInvalid date and time settings. User is being redirected to android settings

Additional message templates (not separate enum codes): UNSUPPORTED_PAYMENT_MODE, MULTIPLE_PAYMENT_APPS_FOUND, CODE_APP_VERSION_NOT_COMPATIBLE.

Recovery-related codes

CodeMeaningAction
PAYMENT_APP_CLOSED_BEFORE_RESPONSEPayment App closed before callbackRun transaction lookup; treat as unsuccessful unless lookup returns a passing success result
APP_NOT_FOUNDPayment App missing on deviceInstall UAT or production Payment App
INVALID_AMOUNTAmount ≤ 0 or over limitFix amount and retry
🚧

If alertError fires on a lookup call, treat the payment as unsuccessful in your POS.

See Terminal integration flows for recovery guidance.