Knowledgebase

There are various reasons for a payment failure or error. These can be caused by passing incorrect/invalid information, processor/networking problems, as well as the issues with the purchaser’s own card or account. When a payment fails, an error code is logged and troubleshooting typically begins by reviewing this code and taking the appropriate next steps. Below is a reference of all error response codes that you may see within StarPay. These codes may not be the same as those used by other payment gateways, so if you are not a StarPay customer, check with your payment gateway for a similar reference.

Error response codes can be viewed within failed payments in Orders & Transactions > StarPay Portal > Transaction Search. Click on the Transaction ID for any transaction with a Failed Status.

1 – System Error
An error within the StarPay system has occurred that prevented the successful processing of the request. Try again.

10 – Validation Error
The request did not pass validation and could not be processed.

20 – Transaction Not Found
The transaction referenced by the request was not found.

21 – Resource Not Found
The resource referenced by the request was not found.

22 – Duplicate Request ID
The Request ID provided in the request has already been used for the merchant.

25 – Terminal Already In Use
The Terminal on which the transaction was attempted is already in use.

29 – Removed From Batch Capture Required
A failure occurred during the adjustment attempt that left the transaction outside of a batch. A new capture operation must be performed to add the transaction back to a batch.

150 – Reversal Options Not Available
The reversal option requested cannot be performed on the transaction provided.

160 – Decline For Address Verification System (AVS) or Card Verification Value (CVV)
The transaction was declined due to the AVS and CVV requirements.

161 – Decline For Address Verification System (AVS)
The transaction was declined due to the AVS requirements.

162 – Decline For CVV
The transaction was declined due to the Card Verification Value (CVV) requirements.

163 – Account Blacklisted
The account used has been flagged as a bad account on the StarPay blacklist.

300 – Configuration Error
There is a configuration error within the StarPay.

400 – Communication Error
There has been a communication error with an external systems that caused the processing of the request to fail.

999 – Authentication Failure
The credentials provided are invalid or user does not have permission for action requested.

1007 – ProcessorDCCRequested
A Dynamic Currency Conversion (DCC) Requested response was received from the the processor. The transaction is being attempted in a different currency than the cardholder card supports.

1020 – ProcessorDecline
The card issuer has declined to process the transaction. Cardholder may contact the card issuer for more information.

1021 – Expired Card
The card issuer has declined the transaction because the card is expired or the expiration date provided is invalid.

1023 – Processor Duplicate
The processor has determined the transaction is a duplicate by their rules.

1024 – Processor Pickup Card
The card issuer has decided to decline the transaction and has requested that the merchant pick up the card from the cardholder.

1025 – Processor Referral Call Issuer
The card issuer has requested that the cardholder call the card issuer to discuss the transaction and to verbally authorize the approval of the transaction.

1030 – Processor Balance Not Available
The card issuer has declined the transaction because the balance is not available on the card account to support the transaction.

1090 – Processor Undefined Decline or Error
The card issuer has declined the transaction for an undefined reason or some error occurred during the card issuers processing of the transaction.

1101 – Processor Invalid Data
The processor considers the data inside the request invalid.

1102 – Processor Invalid Account
There is an incorrect configuration with StarPay.

1103 – Processor Invalid Request
The processor considers the request that was sent invalid.

1104 – Processor Authorization Failed
The processor responded with a failed authorization.

1105 – Processor Not Allowed
Card number or card type submitted is invalid. Merchant may not be configured for submitted card type.

1120 – Processor Out of Balance
This error should not occur because this error only occurs on merchant-initiated batch closes which are not supported.

2001 – Processor Communication Error
The processor experienced an error trying to communicate with the card issuer and the transaction request could not be processed. It is possible that the cardholder will see an open authorization if they view their card statement online after this error; however, the transaction has been voided and will not settle.

2002 – Processor Host Error
The card issuer experienced an error trying to process the transaction request. It is possible that the cardholder will see an open authorization if they view their card statement online after this error; however, the transaction has been voided and will not settle.

2009 – Processor Error
The processor or the card issuer experienced an error attempting to process the request and the transaction request was not processed.

2999 – Processor Unknown Response
The processor sent an unknown error response.