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.
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.