Stripe transaction_not_allowed: What It Means and How to Fix It
transaction_not_allowed means the card or account cannot be used for this type of charge. The customer needs a different payment method.
Contents
transaction_not_allowed means the cardholder's card or bank account has a restriction that prevents this specific type of transaction. The card is not blocked entirely, but it cannot be used for recurring charges, online transactions, or charges in your merchant category.
What does transaction_not_allowed mean?
transaction_not_allowed appears when the card has a restriction that applies to the specific transaction type rather than being blocked outright. This is different from Stripe card_velocity_exceeded: What It Means and How to Recover It, which is a temporary limit that resets within 24 hours. transaction_not_allowed is a standing restriction on the card that requires a different payment method. Common restrictions include:
Cards set to block online or card-not-present transactions. Some customers, particularly those concerned about fraud, configure their cards to only allow in-person purchases.
Cards restricted to specific merchant categories. Corporate cards often have merchant category code restrictions that prevent charges to certain business types.
Cards that do not support recurring billing. Some prepaid cards and certain debit cards cannot be used for subscription charges. The card works for one-time purchases but the issuer blocks recurring authorizations.
Geographic restrictions. Cards configured to only allow domestic transactions will decline charges from foreign merchants.
Is transaction_not_allowed retryable?
No. The restriction is a standing configuration on the card or account. Retrying the same card will produce the same result. The customer needs to use a different payment method or contact their bank to remove the restriction.
How to handle transaction_not_allowed
Email on day 1. Explain that the payment did not go through and ask the customer to try a different card. Keep the message short and direct, not technical. "Your payment method could not be used for this charge" is enough.
Suggest a different card type. If the customer is using a prepaid card or a restricted debit card, a standard credit card or a debit card from a major bank will typically work for subscription charges.
Follow up at day 5 and day 12.
- What does transaction_not_allowed mean on Stripe?
- The card has a restriction that prevents this specific type of transaction, such as blocking online purchases, recurring charges, or charges in your merchant category.
- Can I retry a transaction_not_allowed decline?
- No. The restriction is standing. Retrying will produce the same result. The customer needs a different payment method.
- What should I tell the customer?
- Keep it simple. Tell them their payment method could not be used for this charge and ask them to try a different card. You do not need to explain the technical reason.
- What cards commonly produce transaction_not_allowed?
- Prepaid cards, some debit cards, corporate cards with merchant category restrictions, and cards configured by the cardholder to block online or recurring transactions.
