Free tools / Stripe decline codes / card_velocity_exceeded
Stripe card_velocity_exceeded: card limit declines on SaaS renewals
card_velocity_exceeded means the customer's card hit a limit set by the issuer: the balance or credit available, or a cap on how much the card can spend. The bank keeps refusing the same card until that limit changes, so the fix sits with the customer, not with your retry schedule.
- Decline code
- card_velocity_exceeded
- Type
- Limit reached
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
The customer went over the balance, credit limit or transaction amount limit available on their card.
The charge went over a balance, credit or transaction limit set on the card. The issuer keeps refusing the same card until the customer changes that limit, so do not count on a retry: ask for another card or a higher limit.
Why it happens
- The renewal amount pushed the card over its credit limit or available balance.
- The issuer caps how much the card can spend over a period, and that cap was already used up.
- A per-transaction limit below your price, such as the limits some companies set on employee or virtual cards.
- An annual plan or an upgrade charged a much larger amount than the card usually handles.
What to do
- Check the amount that failed: an annual renewal or a prorated upgrade is more likely to hit a limit than a monthly charge.
- Do not count on Stripe's automatic retries with the same card: the issuer keeps refusing until the limit changes.
- Email the customer a card-update link and explain that a limit on their card was reached.
- Offer two ways out: pay with another card, or ask their bank to raise the limit and then pay through the same link.
- For business customers on spend-controlled cards, suggest they ask whoever manages company cards to adjust the limit.
Should you retry?
Do not count on a retry with the same card: the issuer refuses until the customer changes the limit. Ask for another card or a higher limit, and charge again once the customer confirms one of the two.
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.
This card has reached a limit set by your bank. Please pay with another card, or ask your bank to raise the limit before paying again.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
Your bank declined the payment for {product} because a limit on your card was reached. You can pay with another card here, or ask your bank to raise the limit and then pay with the same link: {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
What is the difference between card_velocity_exceeded and withdrawal_count_limit_exceeded?
Both mean a limit on the card was reached, and Stripe describes them in very similar terms. The names hint at the kind of limit (spending over time versus number of transactions), but for a subscription the response is the same: another card or a higher limit.
Is card_velocity_exceeded the same as insufficient_funds?
No. insufficient_funds is about the money available at that moment and often clears after a pay date. card_velocity_exceeded points to a limit the issuer applies to the card, which usually needs the customer to act.
Can I still collect this month's payment?
Yes, if the customer pays with another card or gets the limit raised. Send the hosted invoice link so they can pay the open invoice directly instead of waiting for the next scheduled attempt.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- 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