invalid_amountThe amount is invalid or too high

Stripe's invalid_amount decline means the payment amount is invalid or over what's allowed. Check the amount first, then the customer's card limits.

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

What does invalid_amount mean?

The payment amount is invalid, or more than the card allows.

Check the amount on your side first. Stripe's next step only sends the customer to their bank once the amount looks correct.

What Stripe says to do

If the amount looks right, the customer needs to check with their issuer that they can make purchases of that size.

What to tell the customer

If the amount is correct, ask the customer to check with their bank whether the card allows a purchase this size.

Example wording
Your bank didn't allow a payment of this amount. Please check with your bank, or use a different card.

Should you retry invalid_amount?

Not with the same amount on the same card. 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 invalid_amount 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.

With local payment methods

Stripe also returns invalid_amount for local payment methods, with the Charge's outcome.reason set to partner_invalid_amount. Stripe's message: "The payment provider doesn't allow the amount." Stripe says retries won't succeed.

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

Related decline codes

All Stripe decline codes