Payment Decline Code Reference
When a subscription payment fails, the issuing bank returns a decline code explaining why. Understanding these codes is essential for building effective payment recovery strategies. This reference covers every major decline code, whether to retry or not, and how to maximize recovery rates.
All Decline Codes
Temporary Failures (Retryable)
Soft declines are temporary. The card is valid but the transaction failed due to a condition that will change — insufficient funds, network issues, or rate limits. Smart retry strategies can recover 70-95% of soft declines automatically.
Insufficient Funds
~28% of all declines · 70-85% recoverable with proper retry
Do Not Honor
~15% of all declines · 40-60% recoverable
Activity Limit Exceeded
~4% of all declines · 80-90% recoverable
Network Timeout
~5% of all declines · 95%+ recoverable
Issuer Unavailable
~3% of all declines · 95%+ recoverable
Velocity Limit
~3% of all declines · 85-90% recoverable
Generic Decline
~10% of all declines · 40-60% recoverable
Processing Error
~4% of all declines · 90-95% recoverable
Permanent Failures (Do Not Retry)
Hard declines are permanent. The card is invalid, blocked, or restricted. Retrying will always fail and can damage your merchant reputation. Recovery requires customer outreach or card updater services.
Expired Card
~20% of all declines · 60-75% with card updater + outreach
Invalid Card Number
~5% of all declines · 30-40% with customer outreach
Lost Card
~3% of all declines · 50-65% with outreach
Stolen Card
~2% of all declines · 20-30% recoverable
Fraud-Related Declines
~5-10% of all declines · 40-60% of false positives recoverable
Currency Mismatch
~2% of all declines · 60-70% with outreach
3D Secure Authentication Failure
~8% of all declines (higher in Europe/PSD2 regions) · 50-65% with outreach
Restricted Card
~3% of all declines · 40-50% with outreach
Pickup Card
~1% of all declines · 10-20% recoverable
Reference Guides
Comprehensive guides covering decline code systems by payment processor and the fundamental soft vs hard classification.
Soft vs Hard Declines: Complete Guide
Every payment decline falls into one of two categories: soft declines (temporary failures that can be retried) and hard ...
GuideStripe Decline Codes: Complete Reference
Stripe translates raw bank decline codes (ISO 8583) into its own simplified set of decline reason codes. While this make...
GuideBraintree Decline Codes: Complete Reference
Braintree (a PayPal service) uses a processor response code system that includes both standard ISO 8583 codes and Braint...
Understanding Payment Decline Codes
Payment decline codes are standardized response codes returned by issuing banks when a transaction is rejected. They follow the ISO 8583 financial messaging standard, though most payment processors (Stripe, Braintree, Adyen) translate these into their own simplified code sets.
The most important classification is whether a decline is soft (temporary, retryable) or hard (permanent, non-retryable). Soft declines like insufficient funds or network timeouts can be recovered by retrying at the right time. Hard declines like expired or stolen cards require customer outreach to collect new payment details.
For SaaS businesses, payment declines are the primary driver of involuntary churn — customers lost not because they chose to leave, but because their payment failed. Understanding decline codes and building appropriate recovery workflows for each type can reduce involuntary churn by 60-80% and recover thousands in monthly recurring revenue.