"Card not supported" decline: what it means and what to do
"Card not supported" means the card can't be used for this kind of purchase, or your account can't take it. How to tell which, and when not to retry.

A “card not supported” decline means this card cannot be used for this kind of payment. Usually the customer’s bank refuses it: the card is limited to some types of merchants, some countries, some currencies or in-person payments only. Sometimes the refusal comes from your own side: your merchant account is not set up to accept that card brand or currency. Retrying the same card on a schedule rarely helps. Either the customer uses another card, or you change your account setup.
This guide covers how Stripe, Adyen, Braintree and Recurly report this decline, how to tell a bank refusal from an account setting, what the card networks say about retries, and what to tell the customer. Every rule below comes from the providers’ documentation, listed in the sources.
What does “card not supported” mean?
Stripe’s decline code card_not_supported reads: “The card doesn’t support this type of purchase.” Its next step: “The customer needs to contact their card issuer to make sure their card can be used to make this type of purchase.”
So the card exists and may work elsewhere. It just will not pay for this purchase, from this merchant. The bank does not say which rule applies. The providers’ docs give the usual cases:
- The type of merchant. Recurly’s
invalid_merchant_typemeans “the card is not allowed to make purchases from you (e.g. a Travel only card trying to purchase electronics)”. Stripe’s card declines guide says FSA or HSA cards in the US “are often limited to certain types of businesses (for example, healthcare providers)”. - The type of card. Adyen’s raw response
12covers a card where “this type of transaction is not permitted”, for example a fleet card. Its response13“usually occurs with Cirrus or Maestro Debit and Prepaid Cards or cards that are not allowed to do online purchases.” - The country. Stripe notes that “some card issuers might not allow purchases from certain countries or outside of their own.”
- The currency. Stripe has a separate code for it,
currency_not_supported: “The card doesn’t support the specified currency.”
Is the problem the card or your account?
This is the first thing to check, because the fix is not the same. Some “not supported” errors are about your merchant account, not the customer’s card:
| Code | Who refused | What it means | Who fixes it |
|---|---|---|---|
Stripe card_not_supported |
The card issuer | The card can’t be used for this type of purchase | The customer, with their bank or another card |
Stripe currency_not_supported |
The card issuer | The card can’t be used in the currency you charged | The customer, or you if you can bill in another currency |
Braintree 2024 Card Type Not Enabled |
Your account | “Your account can’t process the attempted card type” | You, with Braintree |
Recurly card_type_not_accepted |
Your account | “Your merchant account does not accept this card type or specific transaction” | You, with your gateway |
Recurly currency_not_supported |
Your account | “The currency configured on your Recurly account is not accepted by your gateway” | You, with your gateway |
Note the trap with currency_not_supported: on Stripe it is the card that does not support the currency, on Recurly it is your gateway. Same name, opposite fix.
An account-side refusal has a clear sign: every customer with the same card brand or currency fails the same way. If all your American Express renewals fail and the others pass, look at your account first. Telling those customers to call their bank would not help.
What is it called on each network and provider?
| Where | What you see |
|---|---|
| Stripe | card_not_supported; also currency_not_supported |
| Adyen | Refusal reason 10 “Not supported”: “The shopper’s bank does not support or does not allow this type of transaction”; refusal reason 23 “Transaction Not Permitted” |
| Braintree | 2015 Transaction Not Allowed (hard); 2024 Card Type Not Enabled (your account) |
| Recurly | invalid_transaction, invalid_merchant_type; card_type_not_accepted (your account) |
| Visa network code | 57 “Transaction not permitted to cardholder”; 5C “Transaction not supported/blocked by issuer” |
| Mastercard network code | 57 “Transaction not permitted to issuer / cardholder” |
| Discover network code | 57 “Transaction not permitted to issuer / cardholder”; 40 “Requested function not supported” |
The network codes come from Stripe’s network decline codes reference. Adyen maps the network’s 57 and 58 responses to its refusal reason 23. Stripe does not publish which network codes become card_not_supported, so keep the raw network code in your logs when your provider gives it.
If you bill with Chargebee, Zuora or Maxio on top of a gateway, the gateway’s own code is in the payment’s error details. If you sell through a merchant of record such as Paddle, Lemon Squeezy or Polar, the platform collects the payment and handles the retries, so you may only see the result.
A close cousin is the restricted card decline (network code 62), where the card is blocked for this payment by the bank, the cardholder or a lost or stolen report.
Should you retry a “card not supported” decline?
Not on a schedule. The card’s rules do not change from one day to the next, so the same card will most likely fail again. Treat it like a hard decline unless your provider’s advice says otherwise.
- 01 Find who refused The card issuer, or your own account setup
- 02 Fix your account if it is yours Enable the card brand or currency, then retry once
- 03 No retries on a schedule Braintree 2015 is Visa Category 1: do not retry
- 04 Ask for another card Charge the new card at once
What the networks say. Braintree classes 2015 Transaction Not Allowed as hard and puts it in Visa Category 1: “Do not retry”. Braintree adds that “retrying Category 1 declines carry the highest network fees because each retry attempt is fined”, at $0.10 per domestic and $0.15 per international transaction beyond the threshold.
On Stripe, read outcome.advice_code. do_not_try_again means “you shouldn’t use it again for the same transaction”. try_again_later means you can retry. For charges that permit retries, Stripe recommends a maximum of eight, and warns that issuers can see extra retries as potential fraud.
When a retry does make sense:
- The customer says the bank lifted the block, for example on online or foreign payments. Retry once, right away.
- The customer added another card. Charge the new card at once instead of waiting for the next retry slot.
- You fixed your account setup, such as enabling a card brand or currency. Retry the failed renewals once.
Billing tools have their own retry logic (Stripe Smart Retries, Chargebee, Recurly, Braintree Retry). Check what yours does with hard declines; payment retry schedules compared covers the main ones.
Why does a card that worked at signup fail at renewal?
The decline code does not say, but a few changes on your side can turn a working card into an unsupported one:
- You changed the currency. A card that paid in USD may not support EUR, or the reverse. On Stripe, that shows as
currency_not_supported. - You changed how you bill. A new gateway, a new merchant account or a new country of processing can change how the issuer sees your payments. Stripe’s card declines guide says cards issued in a different country from your Stripe account “might see an increased rate of declines”.
- The customer’s card was replaced. A new card from the same bank can be a different product, with different rules.
When many renewals fail with this code after one of these changes, compare the date of the change with the date the declines started.
How do you reduce “card not supported” declines?
- Check the card at signup. A card that cannot pay you should fail while the customer is still on the page, not at the first renewal. Verifying the card when it is saved, with a $0 or small authorization where your provider and the card support it, can catch some of these before the first renewal.
- Know which card brands and currencies your account accepts, and show them at checkout. Braintree’s
2024and Recurly’scard_type_not_acceptedare signs of an account that refuses a brand customers try to use. - Look up the card type when declines cluster. The first digits of a card number tell you its network, and often whether it is debit, credit or prepaid. The free BIN lookup does that in your browser.
- Offer another payment method. A wallet, a bank debit or a local method avoids card-type limits that the customer cannot change.
What should you tell the customer?
Tell them their bank does not allow this card for this payment, and give them a way to pay with another card. Do not show the raw code. Adyen says not to expose the details of the refusal reason to shoppers, “to prevent malicious use”.
Recurly’s customer message for invalid_merchant_type gets the tone right: “Your card is not allowed to complete this transaction. Please try another card.”
A renewal email for this case can read:
Subject: Your card can't be used for your [Product] payment
Hi [First name],
Your bank declined today's payment of [amount] for [Product]. It says this card can't be used for this type of purchase.
The quickest fix is to use another card here: [update payment link]
If you'd rather keep this card, your bank can tell you whether it can be used for online subscription payments.
Your account stays active until [date].
[Sign-off]
Lead with the other card. Some cards, such as an HSA card limited to healthcare merchants, may never be able to pay you, whatever the customer asks the bank.
What mistakes should you avoid?
- Retrying on a fixed schedule. The card’s rules don’t reset, and Visa fines each retry of a Category 1 decline.
- Blaming the customer for an account setting. If one card brand or currency fails for everyone, the fix is with your gateway.
- Reading
currency_not_supportedthe same way everywhere. On Stripe it is about the card, on Recurly about your gateway. - Asking the customer to re-enter the same card. The details are not the problem. Ask for another card or a call to the bank.
- Cancelling at once. Give the customer time and a one-click way to switch cards before the subscription ends.
How NoChurn helps
NoChurn reads the decline code of every failed renewal. A hard decline skips the retries and goes straight to an AI-written recovery email, checked before it is sent, which asks for another card and links to a hosted card update page with no login. It never shows the raw code. See failed payments.
FAQ
What does “card not supported” mean?
The card cannot be used for this type of purchase. On Stripe, card_not_supported means “the card doesn’t support this type of purchase”, and the customer needs to check with their card issuer. Sometimes the cause is on your side instead: your account does not accept that card brand or currency.
Can I retry a “card not supported” payment?
Not on a schedule. The card’s rules don’t change overnight. Braintree’s matching code 2015 is a Visa Category 1 decline: do not retry. Retry once when the customer says the bank lifted the block, adds another card, or when you fix your account setup.
What is the difference between “card not supported” and “restricted card”?
Both mean the bank will not allow this payment on this card. “Restricted card” (network code 62) is a block on the card, for example by country or after a lost card report. “Card not supported” is about the type of purchase the card can be used for.
Why does my card say “not supported” on one site but work on another?
Because the rules depend on the merchant: its type of business, its country and the currency it charges in. A travel-only card or an HSA card, for example, works with some merchants and not others.
How do I know if the problem is my merchant account?
Look for an account-side code, such as Braintree 2024 Card Type Not Enabled or Recurly card_type_not_accepted, and check whether every customer with the same card brand or currency fails. If they do, contact your gateway.
Sources
All accessed 21 November 2026.