IT Retail

Terminal Error Codes

January 26, 2026January 26, 2026

When a transaction doesn’t go through it can be confusing and frustrating, especially if the cause isn’t clear. Here’s a breakdown of the most common reasons a card might be declined, along with the error codes you might see and how to respond.

 

Common Reasons for Transaction Failures

  • Bank Declines — These are the most common and may be due to insufficient funds, a reported lost card, or suspicious activity.
  • Technical Issues — These include terminal malfunctions, poor internet connections, a damaged card, or user error like removing the card too quickly.
  • Incorrect Information — Typing errors in the card number, expiration date, or CVV can lead to failed transactions.
  • Expired Cards — An expired card won’t be accepted and must be replaced with a valid one.
  • Fraud Prevention — Banks may decline a transaction if it triggers their fraud detection systems.
  • Card Restrictions — Some cards are limited to specific transaction types or regions.
  • Limits Exceeded — Banks may block transactions that go over set limits to protect against fraud.

 

Understanding Error Codes

For any transaction processed after April 11, 2024, you can see the specific error code on the Payments page in the Payment Portal. Just click the transaction to view its status and description.

 

Error Code Reference Guide

Error Code Message What It Means What to Do
API_ERROR API Error. Please try again (insert card if possible). The system couldn’t read the card due to a general API failure. Retry. If it still fails, submit a support ticket.
APP_ERROR Application error. Please try again (insert card if possible). There was a problem with the terminal software while trying to read the card. Retry. If it still fails, submit a support ticket.
EMV_ERROR Something went wrong while processing. Please try again (insert card if possible). The chip couldn’t be read—likely due to card damage or early removal. Retry. If it still fails, submit a support ticket.
OFFLINE_DECLINE The processor declined the card. The cardholder’s bank declined the transaction without giving a reason. Ask the cardholder to retry or contact their bank.
POS_CANCEL Canceled by clerk. The transaction was canceled from the POS. Retry the transaction.
REVERSAL Payment declined. The bank or cardholder reversed the transaction authorization. Ask the cardholder to retry with a different card if needed.
USER_CANCEL Canceled by shopper. The cardholder canceled the payment on the terminal. Retry the transaction.
USER_TIMEOUT Timed out waiting for shopper. The terminal didn’t detect a card in time. Retry the transaction.
WEB_TIMEOUT Connection issue. Please check your network and try again. The terminal couldn’t connect to the network to complete the transaction. Check the internet connection and try again.

 

 

Important Notes

  • If a transaction fails with any of these errors, no funds are captured.
  • You won’t be able to capture the payment retroactively.

Need Help?

Can't quite find the answer you're looking for? Our support team is just a call away.