authentication_not_handled
The bank asked for authentication, the payment went ahead without it, and the bank declined again.
| Group | Authentication needed |
|---|---|
| Retry | Needs the customer |
| Customer-facing | Safe to explain |
What it means
The bank asked for authentication, the payment went ahead without it, and the bank declined again.
What Stripe's docs suggest
Run the 3D Secure or strong customer authentication flow. For off-session payments, set up authentication while the customer is present first, and fall back to an on-session payment when needed. Source
Will a retry work?
A retry only works once the customer completes the bank's authentication step.
What to tell the customer
A message you could send: “Your bank needs you to confirm this payment. Please open this secure link to approve it.”
If this hit a subscription renewal
- The customer has to be present to approve the payment. Send them a link to a page where they can complete it.
- Explain plainly that their bank asked them to confirm the payment.
- Retries without the customer won't succeed.
Similar card-network reason codes
Banks also return a raw network code. These raw codes have a similar meaning to authentication_not_handled. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 1A | Extra customer authentication required |
Stripe's network decline code tables
Questions
What does authentication_not_handled mean?
The bank asked for authentication, the payment went ahead without it, and the bank declined again.
Can I retry a authentication_not_handled decline?
A retry only works once the customer completes the bank's authentication step.
What should I tell a customer about authentication_not_handled?
A message you could send: “Your bank needs you to confirm this payment. Please open this secure link to approve it.”
Related codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.