testmode_declineA Stripe test card was used

Stripe's testmode_decline means a Stripe test card number was used for a real payment. A genuine card is needed. What to check in your setup.

Next step
Check your own setup
Hard decline
Not on Stripe's list
Share the reason
Yes

What does testmode_decline mean?

A Stripe test card number was used.

What Stripe says to do

A genuine card must be used to make a payment.

What to tell the customer

Ask the customer to pay with a real card.

Example wording
That card number can't be used for real payments. Please use a different card.

Should you retry testmode_decline?

Not with the test 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 testmode_decline 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 testmode_decline, and follow up from there.

Related decline codes

All Stripe decline codes