Free tools / Stripe decline codes / transaction_not_allowed
Stripe transaction_not_allowed: when the card blocks this type of charge
Stripe documents transaction_not_allowed only as a decline for an unknown reason, but the response usually means the card is not permitted to make this kind of transaction. For a SaaS subscription that usually points to the card, or the cardholder's own settings, blocking online, recurring or cross-border payments. The card works; it just does not work for this charge.
- Decline code
- transaction_not_allowed
- Type
- Card not allowed
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
Stripe gives no reason and says the customer should contact their bank. The network response usually means the card is not allowed to make this kind of transaction (online, recurring or international).
The card cannot be used for this kind of payment (online, recurring or international), or the bank restricted it. Retrying the same card will not help; the customer has the restriction lifted or uses another card.
Why it happens
- The cardholder turned off online or international payments in their banking app.
- The card type does not allow recurring or online payments, as with some debit or corporate cards.
- Your business bills from a different country than the card's, and cross-border payments are blocked.
- A company card policy limits the kinds of merchants the card can pay.
What to do
- Do not retry the same card as is: the issuer refuses this type of transaction every time.
- Tell the customer their bank does not allow this payment on the card, and suggest they check their banking app for online, recurring or foreign-payment settings.
- Offer an alternative straight away: another card through the hosted invoice link.
- For a business customer, suggest checking with whoever manages their company cards.
- Once the setting is changed or a new card is added, collect the open invoice through the link.
Should you retry?
Not as is. The card refuses this type of charge until the customer changes a setting with their bank. Charge again only after they confirm the change, or with a different card.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
Your bank does not allow this kind of payment on this card. Please ask your bank to allow it, or pay with another card.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank reported that the card on file can't be used for this payment for {product}. You can ask your bank to allow it, or pay with another card here: {link}
Thanks,
{company}Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk. Want a ranked list from your own account? Try the free failed payment audit.
Try FlowMRR freeFrequently asked questions
transaction_not_allowed vs restricted_card: what is the difference?
transaction_not_allowed is about the type of payment: this card cannot be used for this kind of charge. restricted_card points to a restriction on the card itself. In both cases the customer lifts the block with their bank or uses another card.
Can the customer fix it quickly?
Sometimes, if the block is a setting in their banking app, such as online or international payments. If it is a limitation of the card type, they will need another card.
Why did the same card work last month?
The cardholder or the bank may have changed the card's settings since, or this charge differs from the last one, for example a larger annual renewal.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- restricted_card
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes