← Back to Stripe Error Codes

Stripe Error: Transaction Not Allowed — What It Means & How to Fix It

Issuer does not allow this specific transaction.

What transaction_not_allowed means in Stripe

The right recovery response depends on whether the decline is temporary, customer-actionable, or unlikely to succeed without a new payment method.

Decline type
Hard or customer-action decline
Retry guidance
Use the decline type to decide whether to retry automatically, wait for customer action, or stop retrying this payment method.

Common causes

  • Issuer blocks merchant category or region
  • Card-level transaction controls
  • Bank policy denied this payment context

How to fix it

  1. Instruct customer to contact issuer and approve merchant charge.
  2. Retry only after customer confirms issuer authorization.
  3. Use an alternate card if restrictions remain.

Recovery email template

Use this as a starting point when the payment needs customer action.

Subject

Payment update needed for Transaction Not Allowed

Body

Hi {{customer_name}}, we could not process your latest payment. Please review or update your payment method here: {{billing_portal_link}}.

Related Stripe decline-code questions

What does transaction_not_allowed mean in Stripe?

It is a Stripe decline code that explains why the issuer or payment network rejected the payment.

Should I retry this failed payment?

Retry only when the decline is likely to recover. Hard declines usually need a new payment method first.

How can RetryKit help?

RetryKit classifies failed invoices, runs timed retries, sends dunning emails, and tracks recovered revenue.

Should you retry this Stripe error?

Hard decline: Generally hard decline. RetryKit should avoid repeated unattended retries and route customer to issuer support quickly.

Stop losing revenue to failed payments. RetryKit automatically recovers failed Stripe payments. Connect in 5 minutes.

Start with RetryKit