Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
    Overview
    Currencies
    Declines
      Card declines
      Stripe decline codes
      Network decline codes
    Payouts
    Recurring payments
    3D Secure authentication
    Refund and cancel payments
    Balances and settlement time
    Receipts
    Handle webhook events
    SCA readiness
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment Methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Beyond payments
Incorporate your company
Crypto
Financial Connections
Climate
Understand fraud
Radar fraud protection
Manage disputes
Verify identities
HomePaymentsAbout Stripe paymentsDeclines

Network decline codes

Learn about Network decline codes and how to resolve them when a charge fails.

Network decline codes are typically alphanumeric error codes that indicate a reason for a payment decline. These codes often come from issuing banks, payment processors, or credit networks. Use the following table to help resolve issues relating to network decline codes:

Raw network codeFailure codeExplanationNext steps
R01, R09insufficient_fundsThe payment process can’t be completed because your customer’s bank account doesn’t have the necessary funds.Contact your customer to verify that they have the required funds, then retry the transaction.
R02bank_account_closedThe payment can’t be processed because your customer’s bank account is closed.Contact your customer to provide new account details, then retry the transaction.
R03, R04bank_account_invalid_detailsThe transaction can’t be processed because the bank account information that your customer provided is incorrect.Contact your customer for correct bank details, then retry the transaction.
R05, R07, R08, R10, R11, R29, R31debit_not_authorizedThis payment doesn’t have an authorized mandate.Collect a new mandate and retry the transaction.
R15recipient_deceasedThe attempt to set up a mandate is made on the account of a potentially deceased individual.Verify your customer’s status before retrying the transaction.
R16bank_account_frozenThe payment can’t be processed because your customer’s bank account is frozen.Contact your customer to provide new account details, then retry the transaction.
R20bank_account_restrictedThe payment can’t be processed because your customer’s bank has blocked direct debits, either by the bank’s actions or your customer’s.Contact your customer to understand the reason for the block. If the bank unblocks the account, retry the transaction.
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access programme.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc