card_velocity_exceededThe card hit a spending limit

Stripe's card_velocity_exceeded decline means the customer went over a balance, credit, or transaction limit. What to tell them and how to test it.

Next step
Customer should contact their bank
Hard decline
Not on Stripe's list
Share the reason
Yes

What does card_velocity_exceeded mean?

The customer has gone over the balance, credit limit, or transaction amount limit on their card.

What Stripe says to do

The customer needs to contact their card issuer for more information.

What to tell the customer

You can tell the customer they've hit a limit on their card. Ask them to contact their bank or use another card.

Example wording
Your card has reached a spending limit set by your bank. Please contact your bank or use a different card.

Should you retry card_velocity_exceeded?

Stripe doesn't say a retry will work. Its next step is for the customer to contact their issuer. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where card_velocity_exceeded shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

To test it in a Stripe sandbox: Stripe's test card 4000000000006975 returns card_declined with decline_code card_velocity_exceeded.

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as card_velocity_exceeded, and follow up from there.

Related decline codes

All Stripe decline codes