How we classify payment failures
Every error code maps to one of 18 reasons a payment fails. This is the reference the tool checks before it answers.
Reasons payments fail 18
Not enough balance
Customer didn't have enough money when the debit was attempted.
WHEN TO RETRY
Cards: no sooner than 24h after the decline, within network caps (Visa: 15 retries per card in 30 days). Recurring: time retries near likely salary credit (1st–7th). UPI Autopay: up to 3 retries in the cycle after the first attempt, inside the permitted IST execution windows; the pre-debit notification is needed before the scheduled debit, not before each retry.
PREVENT IT
Set debit dates near salary credit, and remind customers two days before each debit.
INSUFFICIENT_FUNDSSpending limit reached
A daily, per-transaction or frequency limit set by the customer or bank was hit.
WHEN TO RETRY
Daily or frequency limits: after the limit resets (typically next day). Per-transaction limits don't reset: charge a smaller amount or collect another way. FL/FP first-time UPI limits: after 24h.
PREVENT IT
Tell customers about bank limits before large debits, or bill large amounts in smaller cycles.
LIMIT_EXCEEDEDBank or network was down
Bank, network or gateway was unavailable or timed out. Nothing wrong with the customer.
WHEN TO RETRY
Retry in 1–4 hours. UPI Autopay: only inside the permitted IST windows (before 10:00, 13:00–17:00, after 21:30). NACH: the next presentation cycle.
PREVENT IT
Schedule debits in daytime hours, away from bank maintenance windows.
BANK_OR_NETWORK_DOWNTIMEBank flagged it as risky
Bank or network risk model flagged the payment as suspicious.
WHEN TO RETRY
At most one retry after 24h; otherwise wait for customer to clear it with their bank.
PREVENT IT
Authenticate customers at sign-up (3DS or a verified mandate) so issuers recognise your debits.
ISSUER_RISK_DECLINEBank declined without a reason
Bank declined without saying why (do not honour, generic decline, bare U30).
WHEN TO RETRY
Retry once after 24h unmodified; abandon if the second attempt also fails.
PREVENT IT
Keep a backup payment method on file so a failing card can switch rails instead of lapsing.
AMBIGUOUS_ISSUER_DECLINECustomer didn't complete verification
Customer didn't finish authentication — wrong PIN/OTP, didn't approve, timed out or cancelled.
WHEN TO RETRY
Only when the customer re-initiates or re-authenticates. UPI Autopay and card e-mandates above Rs 15,000 need authentication on each debit (Rs 1,00,000 for mutual fund subscriptions, insurance premiums and credit card bills).
PREVENT IT
Send approval requests when customers are active, with a reminder before the request expires.
AUTH_NOT_COMPLETEDAll error codes 200
| Payment method | Code | Official description | Reason | Flags | Source |
|---|---|---|---|---|---|
| Card | 03 | Invalid merchant | Problem on the merchant's side | — | ISO 8583 |
| Card | 04 | Pick up card | Card reported lost or stolen | Differs by payment method | ISO 8583 |
| Card | 05 | Do not honor | Bank declined without a reason | Differs by payment method Depends on the situation | ISO 8583 |
| Card | 06 | Error | Bank or network was down | Differs by payment method Depends on the situation | ISO 8583 |
| Card | 07 | Pick up card, special condition | Card reported lost or stolen | Differs by payment method | ISO 8583 |
| Card | 12 | Invalid transaction | Problem on the merchant's side | Differs by payment method | ISO 8583 |
| Card | 13 | Invalid amount | Problem on the merchant's side | Differs by payment method | ISO 8583 |
| Card | 14 | Invalid card number | Wrong or outdated payment details | Differs by payment method | ISO 8583 |
| Card | 15 | No such issuer | Wrong or outdated payment details | Differs by payment method Depends on the situation | ISO 8583 |
| Card | 19 | Re-enter transaction | Bank or network was down | Depends on the situation | ISO 8583 |
| Card | 39 | No credit account | Wrong or outdated payment details | Depends on the situation | ISO 8583 |
| Card | 41 | Lost card | Card reported lost or stolen | — | ISO 8583 |
| Card | 43 | Stolen card | Card reported lost or stolen | — | ISO 8583 |
| Card | 46 | Closed account | Account closed | — | ISO 8583 |
| Card | 51 | Insufficient funds | Not enough balance | Differs by payment method | ISO 8583 |
| Card | 52 | No checking account | Wrong or outdated payment details | Differs by payment method Depends on the situation | ISO 8583 |
| Card | 53 | No savings account | Wrong or outdated payment details | Differs by payment method Depends on the situation | ISO 8583 |
| Card | 54 | Expired card | Card expired | Differs by payment method | ISO 8583 |
| Card | 55 | Incorrect PIN | Customer didn't complete verification | — | ISO 8583 |
| Card | 57 | Transaction not permitted to cardholder | Card or account is restricted | Differs by payment method | ISO 8583 |