testmode_decline
The payment used one of Stripe's test card numbers, which can't make real charges.
| Group | Setup, testing and deprecated codes |
|---|---|
| Retry | Retry possible, often needs the customer |
| Customer-facing | Safe to explain |
What it means
The payment used one of Stripe's test card numbers, which can't make real charges.
What Stripe's docs suggest
Use a real card to make a real payment. Source
Will a retry work?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What to tell the customer
A message you could send: “Your card was declined. Please try again or use a different card.”
If this hit a subscription renewal
- Check whether you're in test mode, or whether you're seeing an older code.
- Treat deprecated codes like a generic decline.
Questions
What does testmode_decline mean?
The payment used one of Stripe's test card numbers, which can't make real charges.
Can I retry a testmode_decline decline?
Not on Stripe's hard-decline list, so retries can run, but the bank gave no reason, so the customer may need to call their bank or use another card. Source
What should I tell a customer about testmode_decline?
A message you could send: “Your card was declined. Please try again or use a different card.”
Related codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.