Live Tool · Decline Analytics

Decline Reason Classifier

A taxonomy-driven framework for classifying payment declines into actionable categories. The prerequisite for any billthrough optimization program is knowing which failures are retryable, which are terminal, and which are actually instrumentation gaps dressed up as decline codes.

Master Decline Taxonomy
Every decline code maps to one of four categories. Category determines retry eligibility, retry timing, and escalation path. The most common error in payments analytics is retrying terminal declines — which wastes retry budget and in the fraud case actively worsens the subscriber's standing with their issuer.
4
Categories
Retryable vs Terminal
60%
Avg Retryable Share
Across markets
22%
Generic / Unclassified
Instrumentation gap
11%
Fraud / Risk
Never retry
Full Decline Taxonomy
CategoryTypical CodeShareRetryableRetry WindowRoot CausePriority Action
Insufficient Funds51, NSF28%YesPay period +1 dayTiming mismatch with pay cycleAlign retry to subscriber pay date
Card Expired54, 1412%NoN/AStale card on filePre-expiry update campaign
Generic Error / Do Not Honor05, 5722%Conditional24–48 hrsIssuer policy or unclassifiedInstrument by issuer; isolate pattern
Account Not Authorized62, 4110%NoN/AAccount restriction or closureSubscriber notification; update flow
Fraud / Risk Block59, 6311%NeverN/AIssuer fraud score; velocityDo not retry; flag for review
Technical / Timeout96, 914%Yes1–4 hrsPSP or gateway errorRetry same PSP; escalate if recurring
Invalid Card Number / CVV14, 825%NoN/AData entry error or test cardRe-tokenize; update payment method
Carrier Billing Limit ExceededCB-015%ConditionalMonthly resetCarrier spend cap reachedRetry at billing cycle reset
Wallet Insufficient BalanceWL-023%Yes48–72 hrsWallet top-up pendingNotify subscriber; retry after top-up
Critical Instrumentation Warning

The "Generic Error / Do Not Honor" category at 22% is almost always an instrumentation problem, not a real decline reason. When this category is large, it means your PSP or gateway is returning catch-all codes rather than specific reasons. Reducing this through better instrumentation is often the single highest-ROI first step in any billthrough program because it reveals retryable volume that was previously invisible.

Decline Distribution by Market
Decline composition varies materially by market. What drives failures in the US (generic DNH codes, card expiry) is different from SE Asia (carrier limits, wallet balance) or LATAM (bank transfer failures, regulatory holds). Applying a single global retry strategy misses recoverable volume.
Decline Breakdown
CategoryMarket Sharevs Global AvgRetryableMarket-Specific Note
Market Insight

Decline Distribution by Payment Method
Decline reasons shift dramatically by payment method. Carrier billing failures are dominated by spend limits and network timeouts. Wallet failures are typically balance-related and highly retryable. Bank transfers fail on mandate issues that are almost never retryable without subscriber action.
Decline Breakdown by Method
CategoryMethod ShareRetryableOptimal Retry WindowAction
Method Insight

Retry Action Playbook
The right action for each decline category. These are not generic best practices — they reflect what actually moves billthrough rate across markets and methods at scale.
Framework Logic
How the decline taxonomy was built and why the categories were chosen. The decisions that are not obvious and the tradeoffs that matter in production.
01

Start with instrumentation, not rules

Before building retry logic, audit what your PSP is actually returning. If more than 15% of declines are generic codes, your instrumentation is broken. Retry logic built on bad classifications will optimize the wrong things. The first deliverable in any decline program is a mapping of every code your system receives to a taxonomy category.

02

Separate the retryable question from the retry timing question

These are two different decisions. Whether to retry is determined by the decline category. When to retry is determined by the decline reason within that category. Insufficient funds retries on pay period alignment. Generic errors retry on 24–48 hour intervals. Technical timeouts retry within hours. Conflating these two decisions into a single retry rule is the most common mistake in dunning logic.

03

Never retry fraud-blocked accounts

Retrying a fraud-blocked account does not recover the subscriber. It increases the issuer's fraud score for that account and reduces the probability of future successful billing. The correct action is notification and payment method update, not retry. This is the clearest example of a retry strategy that actively makes billthrough worse over time.

04

Measure recovery rate by category, not overall

An overall retry recovery rate of 30% obscures everything important. Insufficient funds may recover at 55%. Fraud blocks recover at 0%. Generic errors may recover at 25% with good timing or 8% with bad timing. The metric that drives optimization decisions is recovery rate by category and by retry attempt number — not the blended rate that appears on most dashboards.

05

Carrier billing requires its own taxonomy branch

Carrier billing declines do not map cleanly to card taxonomy. Spend limits, network timeouts, and operator policy changes are the primary drivers and none of them behave like card decline codes. Markets with meaningful carrier billing volume — SE Asia, LATAM, parts of Europe — need a parallel taxonomy with different retry rules, different timing, and different escalation paths.