Android SDK Errors
Reference of error codes returned by the Cycle Android SDK.
Payment Error Reference
This table lists the error types you may encounter, their descriptions, likely causes, and suggested solutions.
| Type | Description | Cause of Error | Solution |
|---|---|---|---|
CONNECTION_ERROR | Server connection error | Poor internet connection | Check the internet connection and try again. |
SERVER_ERROR | Transaction execution error | Server-side error | Retry the operation or contact Cycle support. |
TRANSACTION_NULL_OR_EMPTY | Transaction creation error | TransactionId was not assigned during transaction creation | Check that the PaymentContext is filled in correctly. |
NO_SUCH_TRANSACTION | Transaction not found or not unique | Occurs when attempting to perform actions on a transaction that does not exist in the system | For cancel, refund, etc., verify that the correct TransactionId is being passed. |
EMV_ERROR | General EMV error | Error during interaction between the reader and the card | Try reading the card again. |
EMV_TERMINATED | Transaction terminated | Premature card removal or card disruption (for NFC) | Read the card again. |
EMV_DECLINED | Transaction declined | Transaction was declined by the card during the second authorization step | Contact the card issuer or use single-step authorization. |
EMV_CANCEL | Transaction cancelled | Transaction was declined by the card during the second authorization step | Contact the card issuer or use single-step authorization. |
EMV_CARD_ERROR | Card error | Card reading error | Read the card again. |
EMV_DEVICE_ERROR | Reader error | Reader malfunction | Try reading the card again. |
EMV_CARD_NOT_SUPPORTED | Card not supported | The card is not supported | Check the card and try again. |
EMV_NOT_ALLOWED | Chip transaction not allowed | Transaction declined by the card | No action possible. |
EMV_ZERO_TRAN_EMV | Attempt to process a zero-amount transaction | Incorrect transaction amount | Verify that the transaction amount is correct. |
NFC_NOT_ALLOWED | NFC transaction not allowed | Contactless payments are not enabled on the card | Use chip payment instead. |
INVALID_AMOUNT | Refund/cancellation amount exceeds remaining transaction balance | Incorrect amount | Verify the payment amount. |
STANDALONE_FAILED | Payment execution error via TTK protocol | Payment processing error | Requires detailed analysis for each case; contact Cycle support. |
NFC_LIMIT_EXCEEDED | Contactless payment limit exceeded | NFC payment count limit exceeded | Use chip payment instead. |
TTK_FAILED | Payment error via external application | Payment processing error | Requires detailed analysis for each case; contact Cycle support. |
EXT_APP_FAILED | Payment error via external application | External application error | Investigate what went wrong in the external application. |
SWIPE_NOT_ALLOWED | Magnetic stripe transaction not allowed | Attempt to process a swipe transaction when the card has a chip | Use chip payment instead. |