HomeBrandsStripePayments APIauthentication_required
S
authentication_required
Moderate
Stripe · Payments API
Payment requires additional customer authentication to proceed.
Quick Answer
Error code authentication_required on your Stripe Payments API means: Payment requires additional customer authentication to proceed.. This is usually fixable — see the step-by-step guide below.
Affected Models
Likely Causes
  1. Payment instrument, mandate, or account state does not satisfy processing rules.
  2. Transaction amount, currency, or balance constraints violate provider limits.
  3. Risk, compliance, or issuer-side controls blocked authorization/capture flow.
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
Video Guides
Loading video guides…
Search more on YouTube →