Decline Decoder

authentication_not_handled

The bank asked for authentication, the payment went ahead without it, and the bank declined again.

GroupAuthentication needed
RetryNeeds the customer
Customer-facingSafe 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

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.

NetworkRaw codeMeaning (our wording)
Visa1AExtra customer authentication required

Stripe's network decline code tables

What are failed payments costing you?

Turn on JavaScript to use the calculator.

Example values only; use your own from your Stripe dashboard. Open the full calculator.

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.