authentication_requiredThe bank requires authentication
Stripe's authentication_required decline means the bank wants 3D Secure. It's a hard decline for Billing. How to get the customer to authenticate.
- Next step
- Customer should authenticate or use a PIN
- Hard decline
- Yes, on Stripe's list
- Share the reason
- Yes
What does authentication_required mean?
The transaction needs authentication, such as 3D Secure, before the bank will approve it.
Stripe also lists authentication_required as an API error code. Its advice there: if the customer is off-session, notify them to return and complete the payment.
Stripe notes that where regulations like Strong Customer Authentication apply, off-session payments can need authentication and fail with this code.
What Stripe says to do
With Stripe's own checkout and payment forms, this usually starts an authentication step so the customer can try again and approve the payment. For off-session payments, such as a subscription renewal, you may need to ask the customer to come back and pay. If the bank returns this code after the customer has already authenticated, the customer needs to contact their bank.
What to tell the customer
Tell the customer their bank needs them to approve the payment, and send them a link to pay on-session, such as the hosted invoice page.
Your bank needs you to confirm this payment. Please use the link below and approve it when your bank asks, for example with a code or in your banking app.
Draft a full failed payment email for authentication_required
Should you retry authentication_required?
Not automatically. Stripe lists this code as a hard decline. Stripe Billing won't retry the invoice on its own: scheduled retries stay on the invoice, but they only run after the customer adds a new payment method. An off-session retry can't complete authentication, so the customer has to pay on-session.
Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.
Where authentication_required shows up
On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.
Stripe also documents authentication_required as a top-level API error code, so check error.code as well as decline_code when you handle it.
Get failed payments in Slack
ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as authentication_required, and follow up from there.