bank_account_restricted
Moderate
Stripe · Payments API
Bank account has restrictions preventing requested payment flow.
Quick Answer
Error code bank_account_restricted on your Stripe Payments API means: Bank account has restrictions preventing requested payment flow.. This is usually fixable — see the step-by-step guide below.
Affected Models
Applies to all models
Likely Causes
How to Fix It
1
Stripe: Inspect provider response details for instrument, mandate, or risk-specific context.
2
Validate amount/currency/account balance and payment method eligibility.
3
Prompt user for updated payment method or additional authentication if required.
4
Retry payment only with corrected parameters and idempotency safeguards.
5
Track payment failure taxonomy to improve checkout and billing fallback logic.
Pro Tip
This fix requires some technical knowledge. If you're unsure about any step, consider contacting support or a qualified technician.
Related Error Codes