What does "Transaction Declined" mean?
A declined transaction means the payment was rejected — usually by the card issuer or the payment processor, not by Softpay itself. Softpay passes the payment request through to the bank, and the bank decides whether to approve or reject it.
No money was charged. The customer's card is not affected and you can try again or use a different card.
Common reasons a transaction gets declined
The card doesn't have enough funds
The most common reason. The cardholder's account doesn't have enough balance to cover the purchase. The error message may say "Insufficient funds" or simply "Declined".
The card has expired
The card's expiration date has passed. The customer needs to use a different card or contact their bank for a replacement.
Too many wrong PIN attempts
If the wrong PIN has been entered too many times, the card gets temporarily locked. The customer should contact their bank to unlock it, or use a different card.
The card is restricted or blocked
The bank may have placed restrictions on the card — for example, if it has been reported lost or stolen, or if the bank's fraud system flagged the transaction. The customer should contact their bank.
The card doesn't support this type of transaction
Some cards have limitations on certain types of transactions. This can also happen if the card scheme (e.g. Amex, JCB) is not enabled on your Softpay setup.
Duplicate transaction detected
If the same card is used for the same amount twice in a short time, the system may block the second attempt as a suspected duplicate. Wait a moment and try again, or use a different amount if the second transaction is intentional.
The payment processor had a temporary issue
In rare cases, the bank or payment processor may be experiencing a temporary technical problem. The error message may say "Timeout" or "Technical failure". Wait a minute and try again.
Merchant or terminal configuration issue
If every transaction on a terminal is being declined, the problem may be with your account setup rather than the card. Contact your Softpay provider for help.
What should I do?
Ask the customer to try a different card. This resolves the issue in most cases.
If the same card was declined, don't retry more than once or twice. Repeated attempts with the same card won't change the bank's decision and may trigger fraud alerts.
If the error mentions "Timeout": Wait a moment and try again. This is usually a temporary issue.
If all transactions are failing: The issue may be on the terminal or account side. Check your internet connection and contact your Softpay provider if the problem continues.
Understanding the error code
Declined transaction codes follow the same format as other Softpay error codes. You may see codes like T.12500.-4609 or T.12500.-81 — these are specific responses from the payment processor.
The most common ones and what they mean:
What the screen shows | What it means |
Declined / Do not honor | The bank rejected the payment without giving a specific reason |
Insufficient funds | Not enough balance on the card |
Card expired | The card's expiration date has passed |
PIN tries exceeded | Too many incorrect PIN entries — card is temporarily locked |
Suspected fraud | The bank's fraud system flagged the transaction |
Identical purchase | Same card and same amount attempted again — blocked as a duplicate |
Timeout | The payment processor didn't respond in time — try again |
Invalid merchant | There may be a setup issue with your account — contact your Softpay provider |
Offline declined | The card was declined without going online to the bank (e.g. card limits exceeded locally) |
The exact wording may vary slightly depending on your language settings and payment processor.
Does this affect my sales?
A declined transaction means no payment was processed and no money was charged. The customer's card is not affected. If the customer has another card available, they can pay with that instead.
Some decline reasons — like insufficient funds or a locked PIN — are outside of anyone's control and are a normal part of accepting card payments.
Still need help?
If you're seeing an unusually high number of declines, or if every transaction on a terminal is being rejected, please contact your Softpay provider with your App ID and an approximate time when the issue started. This helps us investigate quickly.