Decline Decoder

transaction_not_allowed

The bank declined for an unshared reason.

GroupThe bank said no
RetryNo automatic retry
Customer-facingSafe to explain

What it means

The bank declined for an unshared reason.

What Stripe's docs suggest

The customer should contact their bank for details. Source

Will a retry work?

Stripe's Smart Retries docs list transaction_not_allowed as a hard decline. Scheduled retries keep counting, but a charge only goes through after the customer adds a new payment method. Source

What to tell the customer

A message you could send: “Your bank declined the payment and didn't tell us why. Please check with your bank, or use a different card through this secure link.”

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 transaction_not_allowed. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.

NetworkRaw codeMeaning (our wording)
Visa57Not allowed for this cardholder
Visa58Not allowed at this terminal
Mastercard57Not allowed for this issuer or cardholder
Mastercard58Not allowed for this acquirer or terminal

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 transaction_not_allowed mean?

The bank declined for an unshared reason.

Can I retry a transaction_not_allowed decline?

Stripe's Smart Retries docs list transaction_not_allowed as a hard decline. Scheduled retries keep counting, but a charge only goes through after the customer adds a new payment method. Source

What should I tell a customer about transaction_not_allowed?

A message you could send: “Your bank declined the payment and didn't tell us why. Please check with your bank, or use a different card through this secure link.”

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.