Quick-Reference Guide: Payment Error Messages 💳🚨
In a fast-paced restaurant environment, encountering a payment error at your point-of-sale (POS) terminal can stall your line and create friction for your guests. The good news is that most payment errors can be resolved in seconds—often by simply re-swiping, using a second card, or shifting to an alternative payment method.
This comprehensive troubleshooting guide explains every payment error message that can appear on an NX terminal, helping your floor managers, servers, and bartenders understand exactly what went wrong and what to do next.
🛠️ Hardware & Reader Errors
These messages point to an issue with the physical card reader terminal itself, its connection network, or the way a card was physically swiped, dipped, or tapped. They do not reflect a problem with the customer's financial account.
"Canceled"
What It Means: The transaction sequence was stopped entirely before completion.
Likely Cause: A team member or guest accidentally pressed the Cancel button on the PIN pad, or the terminal timed out while waiting for user interaction.
What To Do: Simply start a brand-new payment attempt. If the terminal continues to time out on its own without user input, reach out to NX Support.
"Reader not responding"
What It Means: The terminal processor attempted to send data to the card reader hardware but received no electronic response.
Likely Cause: The card reader is physically unplugged, powered down, or has dropped its local network connection.
What To Do: Check all physical power lines and data cords. Execute a complete terminal power cycle (reset procedure) to restore communication. If the issue persists after a fresh reboot, contact support for hardware inspection.
"Timeout reading card"
What It Means: The reader opened its transaction window and waited for a card to be presented, but the window closed before capturing data.
Likely Cause: The guest took too long to insert/tap their card, or they pulled a chip card out too quickly mid-read.
What To Do: Re-initiate the payment. Remind the guest to present their card promptly and, if using EMV chip insertion, to leave the card secured in the slot until the terminal screen explicitly prompts them to remove it.
"Bad card or card read"
What It Means: The terminal detected a card but was entirely unable to parse or extract clean data from it.
Likely Cause: The card was swiped too fast, too slow, or at an uneven angle. Alternatively, the EMV chip is dirty/scratched, or the magnetic stripe is demagnetized.
What To Do: Attempt a clean retry—insert the chip firmly or swipe the stripe at a steady pace. If one input method fails, try alternative methods like tapping for contactless pay. If the card consistently fails across multiple swipe attempts, politely ask for a different payment method.
"Command not allowed"
What It Means: The POS terminal received an operational instruction that its active software build is not permitted or configured to execute.
Likely Cause: A system-level configuration conflict. This has nothing to do with the guest's card.
What To Do: Do not continue to retry the action. Contact NX Support immediately to perform a back-office configuration review.
"Debit card not accepted."
What It Means: The customer presented a debit-only card at a terminal currently configured to process credit networks exclusively.
Likely Cause: The card does not feature credit network routing backups (like a Visa or Mastercard logo) and your terminal is restricted to credit-only rails.
What To Do: Ask the customer if they possess a credit card, a debit card backed by a major credit network logo, or cash. If your venue needs to open up debit card processing, contact support to adjust your merchant profile settings.
"Card not accepted"
What It Means: The specific card network presented is not enabled or allowed on your merchant account.
Likely Cause: The card belongs to an unsupported brand (such as an international card network or debit-only card).
What To Do: Request an alternative card brand, confirm the card shows a valid card brand logo (i.e. Visa, MasterCard, American Express or Discover) or payment method from the guest.
🔄 Partial Approvals & Processor Errors
These status messages are returned directly from the payment processing network rather than your local terminal hardware.
"Partial Approval"
What It Means: The customer's banking institution approved a portion of the transaction subtotal but not the entire balance due.
Likely Cause: The card (frequently a prepaid card, gift card, or flexible spending account) has a lower available balance than the total check value.
What To Do: Inform the guest of the exact authorized amount and explain the remaining open balance. Process the rest of the bill using a second card or cash. Do not void the partial approval, as those funds have already been successfully secured.
"Error. Please retry."
What It Means: The processing network encountered a temporary communication breakdown and requests a fresh submission.
Likely Cause: A brief internet blip or processor network interruption. It does not mean the guest's card is invalid.
What To Do: Wait a few seconds for the network to clear, then submit the transaction again. If it fails consecutively, check your restaurant's internet connection.
"Account error. Contact support."
What It Means: The payment gateway rejected the charge due to an issue with your restaurant's merchant profile.
Likely Cause: An invalid or inactive Merchant ID (MID) or Terminal ID (TID) inside your back-office setup.
What To Do: This is a restaurant backend issue, not a customer issue. Apologize to the guest for the system delay and use an alternative terminal or non-card tender if possible. Contact NX Support immediately, as this error can block all card intake.
🛑 Issuer Declines
These error codes mean the guest's specific card-issuing bank has explicitly blocked the transaction. The terminal displays the standard decline codes provided by the credit network.
"Declined - 05"
What It Means: Generic decline. The bank blocked the charge without specifying a public reason.
Likely Cause: Insufficient available credit/funds, or the bank's automated fraud system flagged an unusual spending pattern.
What To Do: Politely notify the guest that the bank declined the transaction, and ask for an alternative payment method.
"Declined - 06"
What It Means: General banking processing error.
Likely Cause: A temporary glitch on the issuing bank's server architecture.
What To Do: Wait a brief moment and attempt the charge one more time. If it fails again, request a different card.
"Declined - 12"
What It Means: Invalid transaction format.
Likely Cause: The transaction structure or format didn't pass validation checks at the issuing bank (common with certain highly restricted corporate or medical spending cards).
What To Do: Request a different card or payment tender.
"Declined - 13"
What It Means: Invalid transaction amount.
Likely Cause: The dollar amount is outside the range permitted for this card, or a data-entry typo resulted in an impossible check total.
What To Do: Double-check the check total on your screen. If the amount is correct, the customer's bank is restricting the sale volume size.
"Declined - 15"
What It Means: No such issuer/unrecognized card number.
Likely Cause: The card number is incorrect or was mis-keyed during manual entry.
What To Do: Carefully re-enter the card data, verifying the numbers and expiration dates with the guest.
"Declined - 39"
What It Means: No credit account attached to the card.
Likely Cause: A debit card with no secondary credit routing was presented at a credit-only terminal interface.
What To Do: Ask for a credit card, a network-backed debit card, or cash.
"Declined - 41" & "Declined - 43"
What It Means: Lost Card (41) or Stolen Card (43).
Likely Cause: The account holder reported the card missing, and the bank has frozen all usage.
What To Do: Decline to process the card. Politely request an alternative payment method. Do not make any personal accusations; the guest may be a secondary user who is completely unaware that the primary account owner placed a security flag on the card.
"Declined - 46"
What It Means: Closed account.
Likely Cause: The card is linked to a bank account that has been officially deactivated.
What To Do: Ask for an entirely different card or payment method.
"Declined - 54"
What It Means: Expired card.
Likely Cause: The card's expiration date has passed.
What To Do: Inform the guest of the expiration date. Ask if they have a renewed replacement card or an alternative tender.
"Declined - 57"
What It Means: Transaction not permitted on this card.
Likely Cause: Corporate or restricted cards blocking specific merchant categories (e.g., a business card blocking restaurant/bar spend), or the user hit a daily bank spending limit.
What To Do: Request a personal card or alternative payment method.
"Declined - 59"
What It Means: Suspected fraud flag.
Likely Cause: The bank's security software flagged the charge due to an unusual location, dollar size, or rapid purchasing pattern.
What To Do: Request a second card. Alternatively, the guest can open their banking mobile app or call the number on the back of the card to approve the venue and retry the charge.
"Declined - 61" & "Declined - 65"
What It Means: Exceeds Withdrawal Limit (61) or Activity Limit Exceeded (65).
Likely Cause: The guest has exhausted their daily cash/credit withdrawal cap, or they have swiped the card too many times within a brief 24-hour frequency window.
What To Do: Ask if they can split the payment across a second card or use cash.
"Declined - 62" & "Declined - 63"
What It Means: Restricted Card (62) or Security Violation (63).
Likely Cause: The card has geographic or service limits (like domestic-use only), or security data like CVV or PIN entries failed verification.
What To Do: Request an alternate card to prevent a security lock on the guest's account.
"Declined - 78"
What It Means: Card not activated.
Likely Cause: The customer received a brand-new or replacement card in the mail but forgot to activate it via phone or mobile banking app before using it.
What To Do: Advise the guest that the card likely needs quick activation. Swap to an alternate payment method while they clear it up.
🚨 When to Contact NX Support Immediately
If you run into any of the following errors, do not ask the guest for a different card. These represent critical system or hardware barriers that can only be resolved by our support engineers or your account representative:
"Reader not responding" (Hardware connection or firmware crash)
"Command not allowed" (POS software terminal permission block)
"Account error. Contact support." (Merchant credential setup error)
📞 Need Assistance? If any of these system errors lock up your floor screens, open a priority ticket directly through your back-office NX Portal dashboard or contact your venue's hardware representative for immediate service.