REST API - Error Codes
A comprehensive list of error codes that may be returned by the Cycle REST API.
Payment Errors
| Code | Error Text | Reason | Solution |
|---|---|---|---|
5000 | ByPass | When repeating EMVConfirm from the mobile client if the mobile client has not received a response. When making an offline payment, a package with such data has already been sent. | You don't need to do anything. |
5001 | Duplicate transaction (DuplicateTransaction) | The transaction request contains the ID of a transaction already existing in the system. | Make sure that the request with this transaction ID has not been executed before, try to find the transaction by the ID that is transmitted, change the ID in the request, repeat the execution. |
5002 | POS mismatch (POS_Inconsistency) | Request sent with incorrect agent ID. | Correct agent ID. Repeat request. |
5003 | Currency mismatch (Currency_Inconsistency) | Check the currency sent in the request. Correct it to the correct one. Repeat request. | |
5004 | The mandatory tax rate is not specified (Invalid_Taxes_RequiredTaxNotPassed) | Specify the tax rate. Repeat request. | |
5005 | Duplicate tax rates indicated (Invalid_Taxes_DublicateTaxPassed) | Checks the request body and removes duplicate tax rates. Repeat request. | |
5006 | Invalid transaction state (Invalid_Transaction_State) | Make a transaction status request, check the status. | |
5007 | Payment has already been processed (Transaction_already_processed) | Such a payment already exists. | Find such a transaction in the system. Check your payment history for a similar payment. |
5008 | Invalid transaction (Invalid_Transaction) | Error: Invalid transaction formation. The packet sent to the server does not allow creating a transaction due to insufficient data or incorrect data. | Correct data. Repeat request. |
5010 | Email address or phone number required (Receipt_email_or_phone_needed) | Email address or phone number values are not filled in. | Enter the buyer's email or phone number. |
5011 | Acquirer not found (Acquirer_Not_Found) | Invalid Acquirer. | Correct AcquirerCode. Repeat request. |
5012 | Error when debiting money from the card (Acquirer_process_error) | General acquiring error. | View the clarifying acquiring error code. If it is not there, send a description of the actions preceding the error and logs to Cycle support. |
5013 | Invalid amount (Invalid_Amount) | General acquiring error. | Check the amount and correct it. Repeat request. |
5014 | Payment verification error (Gate_check_error) | General acquiring error (may occur due to an attempt to perform Expense/Return transactions using the card method). The prepare method checks the data in the request, field composition/field codes. | Description of actions preceding the error and send logs to Cycle support. |
5017 | Reader data error (Reader_Data_Error) | Failed to read the packet coming from the reader. | Try to repeat the transaction, reflash or replace the reader. |
5018 | Cancellation has already been made (Reverse_AlreadyReversed) | Cannot undo twice. | Cancellation is not possible. |
5019 | Payment cannot be canceled (Reverse_OperationNotReversable) | Cannot undo twice. | Cancellation is not possible. |
5020 | The service does not support the cancel operation (Reverse_Cancel_Invalid_Service) | Cannot undo twice. | The reverse option is disabled. Description of actions preceding the error and send logs to Cycle support. |
5021 | Are you sure you want to refund the transaction? (Reverse_Cancel_NA_DoReturnQ) | Confirm or cancel return. | |
5022 | Returns are no longer possible (Reverse_Return_NA) | The period for cancellation/return of goods has expired. | Check the dates, most likely the time for canceling/returning the goods has expired. Usually one business day for cancellation and 2 weeks for return. Contact support. |
5023 | Refunds are only possible to the same payment card with which the payment was made. (Reverse_CardNumberMismatch) | The buyer tries to make a return to the wrong card. | Find the card with which the payment was made, Repeat the request. |
5024 | An error occurred while trying to cancel the transaction (Reverse_Return_Error) | Description of actions preceding the error and send logs to Cycle support. | |
5025 | Invalid input type (Invalid_Input_Type) | Check InputType, correct it to the correct one from the value dictionary. | |
5026 | Error connecting to EMV server (EmvServerConnectError) | Try to repeat the transaction, reflash or replace the reader. | |
5027 | Reader not recognized (Unrecognized_Reader) | Description of actions preceding the error and send logs to Cycle support. | |
5028 | Transaction not found (Tran_Not_Found) | Description of actions preceding the error and send logs to Cycle support. | |
5029 | An error occurred while trying to cancel the transaction (Reverse_Cancel_Error) | Description of actions preceding the error and send logs to Cycle support. | |
5030 | Service not found (Service_not_found) | Description of actions preceding the error and send logs to Cycle support. | |
5031 | Reverse_Mode_Invalid | Description of actions preceding the error and send logs to Cycle support. | |
5032 | OrderNotFound | Description of actions preceding the error and send logs to Cycle support. | |
5033 | EMV server returned an error (EMVFinishedResultInvalid) | Description of actions preceding the error and send logs to Cycle support. | |
5034 | In order to complete the operation, additional data is needed (AdditionalFieldsRequired) | System settings error. | Description of actions preceding the error and send logs to Cycle support. |
5035 | Incorrect data was entered. Try again (AdditionalFieldsError) | System settings error. | Description of actions preceding the error and send logs to Cycle support. |
5036 | Error when debiting money from the card (GateCalcFeeError) | System settings error. | Contact the card publisher. |
5037 | Error when debiting money from the card (AcquirerCalcFeeError) | Error in financial institution settings in the system. | Description of actions preceding the error and send logs to Cycle support. |
5038 | Error when debiting money from the card (CardportCalcFeeError) | Error in financial institution settings in the system. | Description of actions preceding the error and send logs to Cycle support. |
5039 | Financial institution not specified (FinstNotSet) | Error in financial institution settings in the system. | Description of actions preceding the error and send logs to Cycle support. |
5040 | AcquirerSelectionRequired | Description of actions preceding the error and send logs to Cycle support. | |
5041 | PIN required (PINRequired) | Error in financial institution settings in the system. | Description of actions preceding the error and send logs to Cycle support. |
5042 | InvalidConfigured | Description of actions preceding the error and send logs to Cycle support. | |
5043 | public const int IssuerNotServed | Description of actions preceding the error and send logs to Cycle support. | |
5044 | Client settings prohibit making payments | Description of actions preceding the error and send logs to Cycle support. | |
5050 | Error sending mail (public const int EmailSendError) | Description of actions preceding the error and send logs to Cycle support. | |
5051 | Error sending SMS (public const int SmsSendError) | Description of actions preceding the error and send logs to Cycle support. | |
5052 | Service error in the seller's system (public const int CAE_Failed) | Description of actions preceding the error and send logs to Cycle support. | |
5054 | Attempting to cancel a transaction that is still in "Pending Payment" | Description of actions preceding the error and send logs to Cycle support. | |
5060 | Offline mode is not enabled | Description of actions preceding the error and send logs to Cycle support. | |
5061 | The check is empty | Description of actions preceding the error and send logs to Cycle support. | |
5062 | Offline mode only works for cash | Description of actions preceding the error and send logs to Cycle support. | |
5063 | Payment time is empty | Description of actions preceding the error and send logs to Cycle support. | |
5064 | The request cannot be processed without GPS coordinates | Coordinates not specified. | Specify coordinates. Repeat request. |
5066 | Duplicate transaction (A duplicate of payment for same amount and payment card is currently processing) | The payment that preceded the double has not yet been archived and is in “Awaiting payment”. | Wait for the allotted protection time and perform the transaction again. |
5065 | A duplicate transaction was found for the same amount using the same card | The payment that preceded the take has already been completed is archived. | If necessary, carry out the transaction after the time limit to limit duplicate transactions (usually 5-10 minutes). |
5068 | The terminal is not configured correctly (Acquirable Inputtypes InvalidTerminal) | Client terminal settings are missing or incorrectly configured. | Check and set the appropriate terminal client settings. |
5071 | Incorrect external order item format | Error when trying to cancel an operation on items in which a product item name that does not match the original was transferred. (or when trying to cancel an already canceled item). | Check that the data regarding the original payment is correct. |
5076 | invalid emv mode | SingleStepAuthMode for reverse is not specified or missing. | The request for reverse via chip or NFC must contain SingleStepauthMode:true. |
5077 | Payment description required | There is no description in the payment. | Description of actions preceding the error and send logs to Cycle support. |
5100 | AcquiringEMVConfirmCode_APPROVED | Description of actions preceding the error and send logs to Cycle support. | |
5120 | An error occurred during the operation (AcquiringEMVConfirmCode_Failure) | Chip rejected payment. | Contact your bank, do not try again until then. |
5130 | Operation aborted (AcquiringEMVConfirmCode_TERMINATED) | Chip rejected payment. | Contact the card publisher. |
5131 | Operation diverted (AcquiringEMVConfirmCode_DECLINED) | Chip rejected payment. | Contact the card publisher. |
5132 | Operation diverted (AcquiringEMVConfirmCode_CONDITION_NOT_SATISFIED) | Chip rejected payment. | Contact the card publisher. |
5133 | Operation cancelled (AcquiringEMVConfirmCode_CANCEL) | Chip rejected payment. | Contact the card publisher. |
5134 | Card error (AcquiringEMVConfirmCode_CAPK_FAIL) | Chip rejected payment. | Contact the card publisher. |
5135 | Card error (AcquiringEMVConfirmCode_NOT_ICC) | Chip rejected payment. | Contact the card publisher. |
5136 | Card error (AcquiringEMVConfirmCode_MISSING_MANDATORY_DATA) | Chip rejected payment. | Contact the card publisher. |
5137 | Card error (AcquiringEMVConfirmCode_INVALID_ICC_DATA) | Chip rejected payment. | Contact the card publisher. |
5138 | Card blocked (AcquiringEMVConfirmCode_NO_EMV_APPS) | Chip rejected payment. | Contact your bank, do not try again until then. |
5139 | Card blocked (AcquiringEMVConfirmCode_CARD_BLOCKED) | Chip rejected payment. | Contact your bank, do not try again until then. |
5140 | Card blocked (AcquiringEMVConfirmCode_APPLICATION_BLOCKED) | Chip rejected payment. | Contact your bank, do not try again until then. |
5141 | Reader error (AcquiringEMVConfirmCode_DEVICE_ERROR) | The reader could not establish a connection with the card. | The contacts on the card may be dirty. Try again. |
5142 | Card not supported (AcquiringEMVConfirmCode_CARD_NOT_SUPPORTED) | The reader could not establish a connection with the card. | Use another card. |
5201 | Fraud in the country of the issuing bank (Fraud_by_Country_of_bank_issuer) | There are restrictions on use for this card. | Do not go beyond the established limits, or use a different card. |
5204 | Unable to calculate commission | Tariff configured incorrectly. | Description of actions preceding the error and send logs to Cycle support. |
Other Errors
| Code | Error Text | Reason | Solution |
|---|---|---|---|
1 | An error has occurred | Description of actions preceding the error and send logs to Cycle support. | |
501 | Incorrect login or password | Make sure the entered email and password are correct. Check keyboard layout and CapsLock. | |
502 | Account deactivated | It is impossible to log in with this account. | You need to contact the client administrator. |
504 | Password needs to be changed | It is impossible to log in with this account. | You need to contact the client administrator. |
550 | Invalid email | It is impossible to log in with this account. | Check the entered data and try again. |
551 | Invalid name | It is impossible to log in with this account. | Check the entered data and try again. |
552 | Wrong phone | It is impossible to log in with this account. | Check the entered data and try again. |
553 | Invalid password | It is impossible to log in with this account. | Check the entered data and try again. |
554 | Incorrect legal address | Check the entered data and try again. | |
555 | Wrong language | Check the entered data and try again. | |
556 | Incorrect physical address | Check the entered data and try again. | |
557 | Wrong country | Check the entered data and try again. | |
558 | Invalid terminal | Check the entered data and try again. | |
559 | Invalid currency | Check the entered data and try again. | |
560 | Email already registered | Check the entered data and try again. | |
561 | Invalid tariff | Check the entered data and try again. | |
562 | Name already taken | Check the entered data and try again. | |
563 | The specified email is not registered in Cycle | Check the entered data and try again. | |
564 | Invalid GMT value | Your device's time zone is incorrectly configured. | Correctly set the time zone. |
570 | The branch has not been transferred | Check the entered data and try again. | |
580 | Financial institution not transferred | Check the entered data and try again. | |
601 | The item contains nested items or has already made payments | This item cannot be deleted. | |
602 | Account not found | Description of actions preceding the error and send logs to Cycle support. | |
603 | Access denied | Contact the administrator. | |
701 | Data validation error | Description of actions preceding the error and send logs to Cycle support. | |
702 | The specified email is not registered | Description of actions preceding the error and send logs to Cycle support. | |
901 | Invalid terminal alias | Check the entered data and try again. | |
902 | Incorrect terminal name | Check the entered data and try again. | |
903 | Class name is too long | Check the entered data and try again. | |
904 | Too many characters for the Contactless Card Acceptance field | Check the entered data and try again. | |
905 | Too many characters for the Self-Service field | Check the entered data and try again. | |
906 | Too many characters for the Terminal Type field | Check the entered data and try again. | |
907 | Too many characters for Region Code field | Check the entered data and try again. | |
908 | The terminal is in use | Description of actions preceding the error and send logs to Cycle support. | |
910 | Too many characters for the MCC code field | Check the entered data and try again. | |
911 | Too many characters for the Title field | Check the entered data and try again. | |
912 | Too many characters for Description field | Check the entered data and try again. | |
913 | Too many characters for the "Seller ID in PS" field | Check the entered data and try again. | |
914 | Too many characters for the Currency field | Check the entered data and try again. | |
915 | Too many characters for the Country field | Check the entered data and try again. | |
916 | Too many characters for the Owner field | Check the entered data and try again. | |
917 | Too many characters for Region field | Check the entered data and try again. | |
918 | Too many characters for the Department field | Check the entered data and try again. | |
919 | Too many characters for the City field | Check the entered data and try again. | |
920 | Too many characters for Location field | Check the entered data and try again. | |
921 | Too many characters for Postal Code field | Check the entered data and try again. | |
922 | Too many characters for the Phone field | Check the entered data and try again. | |
923 | Too many characters for the field "Time offset relative to the processing center (in minutes)" | Check the entered data and try again. | |
924 | Too many characters for the Terminal Capabilities field | Check the entered data and try again. | |
925 | Too many characters for the "Location Latitude" field | Check the entered data and try again. | |
926 | Too many characters for the "Location Longitude" field | Check the entered data and try again. | |
1201 | Reader data error | Failed to read the packet coming from the reader. | Try to repeat the transaction, reflash or replace the reader. |
1202 | Reader not found | The reader's serial number was not found in the database. | Try to reflash or replace the reader. |
1203 | Duplicate reader transaction number | Emergency situation. Perhaps someone is trying to hack the reader. | Description of actions preceding the error and send logs to Cycle support. |
1204 | Error decrypting reader data | Failed to decrypt data received from the reader. | Try to repeat the transaction, reflash or replace the reader. |
1205 | Invalid reader type | Try to repeat the transaction, reflash or replace the reader. | |
1206 | Invalid reader data | Failed to read the packet coming from the reader. | Try to repeat the transaction, reflash or replace the reader. |
1207 | Reader disabled | The reader is blocked in the database. | Contact the Cycle server administrator or replace the reader. |
1209 | InvalidReaderTypeForPIN | Description of actions preceding the error and send logs to Cycle support. | |
1210 | Error reading card data from reader | Failed to decrypt data coming from the reader. | Try to repeat the transaction, reflash or replace the reader. |
1211 | EMV transaction required | Chip transaction required. | Attempt three times to complete a chip transaction. If unsuccessful, the system will accept a swipe. |
1401 | Invalid user id | Description of actions preceding the error and send logs to Cycle support. | |
1402 | No accounts found | Description of actions preceding the error and send logs to Cycle support. | |
1501 | Insufficient rights | You need to contact the administrator. | |
1502 | Wrong action | Description of actions preceding the error and send logs to Cycle support. | |
2000 | Invalid email address for check | Description of actions preceding the error and send logs to Cycle support. | |
2001 | Invalid phone number for check | Description of actions preceding the error and send logs to Cycle support. | |
2002 | Recurrent ID not passed | Description of actions preceding the error and send logs to Cycle support. | |
2003 | An error occurred while checking the recurrent | Description of actions preceding the error and send logs to Cycle support. | |
2004 | An error occurred while creating the recurrent | Description of actions preceding the error and send logs to Cycle support. | |
2005 | Duplicate recurrent | Description of actions preceding the error and send logs to Cycle support. | |
2006 | An error occurred during payment card verification | Failed to save card data for recurrent. | Contact the bank that issued the card. |
2007 | An error occurred during payment card verification. The card does not allow recurring transactions | Failed to save card data for recurrent. | Contact the bank that issued the card. |
2008 | An unconfigured recurrent cannot be started | Configure recurrent: specify the frequency of recurrent payments (steps). | |
2010 | Failed to validate card, please try again later | Try again later or contact the acquiring bank. | |
2011 | You can't create a recurrent without steps | Specify the frequency of recurrent payments (steps). | |
9001 | Invalid product field value | Check the entered data and try again. | |
9002 | Invalid product code | Check the entered data and try again. | |
9003 | Invalid product header value | Check the entered data and try again. | |
9004 | Invalid product value | Check the entered data and try again. | |
9005 | Product field cannot be deleted | Check the entered data and try again. | |
9006 | The product cannot be removed | Check the entered data and try again. | |
9007 | Invalid product field value | Check the entered data and try again. | |
9008 | Required product field not found | Description of actions preceding the error and send logs to Cycle support. | |
9009 | Unknown product field | Description of actions preceding the error and send logs to Cycle support. | |
9010 | Empty product field | Check the entered data and try again. | |
10001 | Invalid amount | Check the entered data and try again. | |
10002 | Invalid amount | Check the entered data and try again. | |
10003 | Invalid currency | Check the entered data and try again. | |
10004 | Invalid currency | Check the entered data and try again. |
EMV Errors
| Code | Error Text |
|---|---|
1 | APPROVED |
30 | TERMINATED |
31 | DECLINED |
32 | CONDITION_NOT_SATISFIED |
33 | CANCEL |
34 | CAPK_FAIL |
35 | NOT_ICC |
36 | MISSING_MANDATORY_DATA |
37 | INVALID_ICC_DATA |
38 | NO_EMV_APPS |
39 | CARD_BLOCKED |
40 | APPLICATION_BLOCKED |
41 | DEVICE_ERROR |
42 | CARD_NOT_SUPPORTED |
43 | SELECT_APP_FAIL |