withdrawal_count_limit_exceededThe card is over its limit

Stripe's withdrawal_count_limit_exceeded decline means the customer hit their balance or credit limit. Stripe says to use another payment method.

Next step
Customer should use another card
Hard decline
Not on Stripe's list
Share the reason
Yes

What does withdrawal_count_limit_exceeded mean?

The customer has gone over the balance or credit limit available on their card.

Compare card_velocity_exceeded, which Stripe describes the same way but adds transaction amount limits, and sends the customer to their issuer instead.

What Stripe says to do

The customer needs to use an alternative payment method.

What to tell the customer

You can tell the customer the card is over its limit and ask for another payment method.

Example wording
Your card is over its available limit for this payment. Please use a different card or payment method.

Should you retry withdrawal_count_limit_exceeded?

Stripe's next step is another payment method, not a retry. 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 withdrawal_count_limit_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.

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 withdrawal_count_limit_exceeded, and follow up from there.

Related decline codes

All Stripe decline codes