Common POS errors: quick reference
Purpose: Look up an on-screen error and get the fix in seconds, without reading a whole runbook.
When to use this: A payment failed or a screen shows an error and you need the next move now. Find the message you see, read what it means, do the quick fix. The last column links to the full procedure if the quick fix doesn't clear it.
Skim the message you see on screen in the first column. The codes (like 05 or 51) come from the card issuer, not from us, they tell you why the bank said no.
Payment device & gateway errors
These come from the counter workstation or the reader.
| You see | What it means | Quick fix | Full procedure |
|---|---|---|---|
| Could not communicate with Payment Provider | The till can't reach the payment service. | Confirm the payment service is running, then have the till retry. | Workstation · Common errors |
| Socket Error … 3006 | The payment gateway on the PC isn't running. | Start the gateway (NETePay), then retry. | Workstation · Common errors |
| Timeout waiting for PinPad | The customer didn't act in time, or the reader is asleep. | Wake the reader and run the payment again. | Workstation · Common errors |
| Failed on Com Port / NAK | The reader fully lost its connection to the PC (usually the end of a cascade). | Power-cycle the reader: a P400 (one cable) unplug and replug; an M400 (separate power) disconnect power and USB. Then restart the service. | Workstation · Terminal & EMV |
| Declined or parsing gateway error while adding to a running tab | Common on bar tabs when topping up an authorization through the night. | Re-run it as a brand-new authorization on the same card. | Workstation · Common errors |
Handheld errors
These come from the handheld app.
| You see | What it means | Quick fix | Full procedure |
|---|---|---|---|
| App won't respond / closed | The app isn't running. | Tap the Vitabyte tile to reopen it, or tap Back To POS. | Handheld · Common errors |
| Connection Lost | The reader dropped mid-transaction. | Tap Retry; if it stays, tap Restart App; last resort, reboot the device. | Handheld · Reader & EMV |
| Payments cancel on their own | Usually low battery / power-saving. | Charge the device and turn off battery saver. | Handheld · Common errors |
| Payments are slow | Weak Wi-Fi. | Move closer to the access point or fix the network. | Handheld · Common errors |
| Card times out / Remove Card | The reader timed out. | Retry; on a VP3300/VP3350, tap the card on the back of the device. | Handheld · Reader & EMV |
What the decline codes mean
When the bank declines a card, the screen shows a short code. These are the ones you will see most. For what the codes mean across processors, the three-digit codes (a 605 is an 05), and the virtual-wallet increment declines, see Error codes.
| Code | Means | What to tell the customer |
|---|---|---|
| 05 | Do not honor (the most common decline) | The bank declined it. Try another card. |
| 51 | Insufficient funds | Try another card. |
| 54 | Expired card | Card is expired, use a different one. |
| 14 | Invalid card number | Re-key or use a different card. |
| 55 | Incorrect PIN | Re-enter the PIN. |
| 59 | Suspected fraud | Try a different card. (When testing, use a debit card.) |
We never make up codes. Every code here comes from the card issuer's response as the app reads it. WorldPay and TSYS can phrase or number some responses differently, Error codes explains the pattern.
