authentication_not_handledAuthentication was required but skipped
Stripe's authentication_not_handled decline means a payment that needed 3D Secure went ahead without it. How to fix the flow and when to retry.
- Next step
- Customer should authenticate or use a PIN
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does authentication_not_handled mean?
Related to authentication_required. The payment went ahead without the authentication the bank asked for, so the issuer declined again.
Stripe's next step here is a change to your payment flow, not something the customer can fix alone.
What Stripe says to do
Run the 3D Secure or strong customer authentication flow. For off-session payments, collect and prepare authentication while the customer is on-session, then fall back to an on-session payment if needed.
What to tell the customer
Tell the customer their bank needs them to approve the payment and give them a way to do it on-session.
Your bank needs you to confirm this payment. Please use the link below and approve it when your bank asks.
Should you retry authentication_not_handled?
Not without authentication. Stripe's next step is to run the authentication flow first. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.
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_not_handled 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.
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_not_handled, and follow up from there.