Free tools / Stripe decline codes / authentication_not_handled
Stripe decline code: authentication_not_handled
authentication_not_handled is one of the decline codes Stripe returns when a card payment fails, in last_payment_error.decline_code on the PaymentIntent or outcome.reason on the Charge. Stripe's label for it is "Authentication not completed". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.
- Decline code
- authentication_not_handled
- Type
- Authentication required
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
Related to authentication_required: the bank asked for authentication (3-D Secure / SCA), the payment went ahead without it, and the bank declined again.
Authentication required. The bank wants the cardholder to confirm the payment (3-D Secure / SCA). Stripe cannot retry headlessly; the customer must complete it from the hosted invoice.
Should you retry?
No: do not retry. No. The bank will refuse the same card as is, or Stripe or the network asked not to try again. Retrying wastes an attempt and can breach the card networks' reattempt rules. Change what is wrong, or ask for another card.
Recommended action
Who can fix it: The customer — needs to act. Send the hosted invoice link so the customer completes the authentication. For renewals charged without the customer present, set up authentication while they are present first.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
Your bank needs you to confirm this payment before it can go through. Please pay again and complete the verification when prompted.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank asked for a quick confirmation before approving the payment for {product}. It takes a few seconds: {link}
Thanks,
{company}Stripe's documentation
Stripe lists this code, with its advice for the customer, in its decline codes reference. The data on this page was last checked against it on 12 November 2026.
Related decline codes
Codes that behave the same way, to read next.
Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk.
Try FlowMRR free