POS terminals may display Declined, Issuer Unavailable, Network Error, Do Not Honour, Invalid PIN, Reversal Pending or other messages. This guide explains what those responses generally mean and gives a safe next step without pretending every terminal or bank behaves identically. Agents learn to check connectivity, paper, battery, time settings and transaction status before retrying. Customers learn when to review

POS errors are handled through the terminal, bank and provider routes, not one universal USSD code.

What to dial first

Need Code or route Use it for
Terminal status POS terminal screen/receipt Read approved, declined or failed
Customer bank Official bank support Report debit without cash/goods
Terminal provider Provider support Report terminal or settlement issue

Step-by-step

  1. Read the exact POS error message.
  2. Print or save the receipt if available.
  3. Ask customer to check debit status privately.
  4. Check terminal transaction history.
  5. Do not release cash/goods unless value is confirmed.
  6. Escalate with receipt/reference.

Expected result

A resolved case should have approved status, reversal, settlement or a complaint ticket.

Alternatives

Use transfer, wallet or another terminal if no debit occurred and customer agrees.

Common errors and fixes

  1. Declined: do not release value.
  2. Issuer unavailable: wait/retry carefully.
  3. Failed but debited: keep evidence and report.

Never ask a customer to reveal card PIN while troubleshooting.

Quick POS-error answer

For POS errors, read the terminal message, keep the receipt, confirm whether the customer was debited, and avoid releasing cash or goods until value is confirmed. Escalate failed debits through the bank, terminal provider or acquirer with transaction evidence.

Why POS errors happen

A POS terminal depends on power, network, terminal provider, card bank, payment switch and merchant settlement. If one part fails, the terminal may decline, time out or print a failed receipt.

Agents and merchants should not treat every error the same. Declined may mean the bank refused the transaction, while failed after debit needs dispute evidence.

Read the message before reacting

Common messages include declined, issuer unavailable, insufficient funds, invalid PIN, network error, reversal pending or failed. The exact wording depends on the terminal provider.

If the customer receives a debit alert, do not argue based only on memory. Collect the receipt, check terminal history and follow dispute procedures.

Practical error-response steps

Use a consistent response so staff and customers know what to expect.

  1. Check terminal network and battery.
  2. Read the exact error message.
  3. Print or save the receipt where possible.
  4. Ask the customer to confirm debit status without exposing private details.
  5. Check terminal transaction history.
  6. Do not pay cash or release goods unless value is confirmed by your business rules.
  7. Escalate with the provider when debit occurs without value.

For repeated errors, contact your terminal provider and document the times. It may be a network or provider issue.

POS error messages and actions

Error Possible meaning Agent action Customer action
Declined Bank refused transaction Do not release value Use another method
Issuer unavailable Customer bank not reachable Retry later if safe Contact bank if debited
Network error Terminal connection issue Check signal/SIM Wait for status
Failed but debited Unclear completion Keep slip and escalate Report with evidence

Three POS error examples

The following examples explain three POS error examples and show how the guidance applies in different situations.

1. Issuer unavailable at rush hour

The customer bank may be temporarily unreachable. The agent should not force repeated attempts if the customer starts receiving debit alerts.

2. Invalid PIN

The customer entered the wrong card PIN. The agent should allow the customer to retry privately without seeing the PIN.

3. Failed withdrawal with debit

The agent should keep the failed receipt and guide the customer to report through the bank while also checking terminal support.

Protect both customer and business

Never ask a customer to reveal card PIN. Do not keep customer cards out of sight. Do not release cash because of pressure when the terminal shows failed and no settlement is confirmed.

Use official terminal provider support and bank dispute routes. Keep receipts and transaction IDs because they are the language payment teams understand.

POS error FAQs

The following examples explain pOS error FAQs and show how the guidance applies in different situations.

Should I retry immediately?

Retry only if no debit occurred and the customer agrees. If debited, document first.

Who reverses failed POS debit?

The bank and payment providers handle reversal or investigation through official processes.

Can a screenshot replace a POS receipt?

No. It can support a case, but receipts and terminal records are stronger.

Why do errors happen more in some areas?

Poor connectivity, provider downtime and power issues can affect terminals.

Errors need records, not arguments

A calm error process protects agents, merchants and customers. Read the message, keep the slip and escalate with evidence.

Use our POS Agent Handbook for daily checks and failed transaction logs.

Terminal responsibility

Some terminal faults require the provider rather than a retry. NIBSS’s POS certification information describes responsibilities across NIBSS, terminal service providers, acquirers and merchants; contact the organisation responsible for your device.

Verification record

Last fact-check
July 31, 2026
Method
Official provider or regulator sources reviewed where available; live menus control account-specific actions.
Reviewed by
Nigeria USSD Codes Editorial Team

Primary official sources:

Article note

Last reviewed: July 31, 2026. This independent guide is informational and does not replace instructions from your bank, telecom provider, regulator, or service provider. Verify sensitive actions through an official channel before sending money or sharing information.

Nigeria USSD Codes Editorial Team

Nigeria USSD Codes Editorial Team

Publication editorial team

Nigeria USSD Codes

The Nigeria USSD Codes Editorial Team researches, reviews and maintains practical guides using official provider and regulator sources where available. Corrections are checked before publication, and sensitive actions are directed back to the responsible provider.