transaction_not_allowed
The bank declined for an unshared reason.
| Group | The bank said no |
|---|---|
| Retry | No automatic retry |
| Customer-facing | Safe 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
- The bank won't tell you more, so the customer has to ask, or use another card.
- Email a card-update link and suggest a different card if the problem continues.
- Check whether CVC and address checks passed when the card was saved. Failed checks are a hint.
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.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 57 | Not allowed for this cardholder |
| Visa | 58 | Not allowed at this terminal |
| Mastercard | 57 | Not allowed for this issuer or cardholder |
| Mastercard | 58 | Not allowed for this acquirer or terminal |
Stripe's network decline code tables
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
- approve_with_id
- call_issuer
- card_not_supported
- currency_not_supported
- do_not_honor
- generic_decline
- invalid_account
- invalid_amount
- All decline codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.