insufficient_fundsThe card doesn't have enough funds
Stripe's insufficient_funds decline means the card can't cover the payment. Stripe's next step is another payment method. Retry and email guidance.
- Next step
- Customer should use another card
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does insufficient_funds mean?
The card doesn't have enough funds to complete the purchase.
Stripe's card decline guide suggests offering a buy now, pay later option to reduce declines for insufficient funds.
What Stripe says to do
The customer needs to use another payment method.
What to tell the customer
You can tell the customer the card didn't have enough funds. Ask them to use another payment method or make sure funds are available.
Your bank declined this payment because the card didn't have enough available funds. Please use a different payment method, or let us know once funds are available.
Should you retry insufficient_funds?
Stripe doesn't say a retry on the same card will work. Its next step is another payment method. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule. Stripe recommends at most eight retries for charges that allow them.
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 insufficient_funds 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.
Stripe also documents insufficient_funds as a top-level API error code, so check error.code as well as decline_code when you handle it.
To test it in a Stripe sandbox: Stripe's test card 4000000000009995 returns card_declined with decline_code insufficient_funds.
With local payment methods
Stripe also returns insufficient_funds for local payment methods, with the Charge's outcome.reason set to partner_insufficient_funds. Stripe's message: "The customer has insufficient funds with the payment provider." Stripe says a retry might succeed after the customer resolves the issue with their account. For direct debits with retries turned on, insufficient funds is the failure Stripe retries.
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 insufficient_funds, and follow up from there.