Decline Decoder

testmode_decline

The payment used one of Stripe's test card numbers, which can't make real charges.

GroupSetup, testing and deprecated codes
RetryRetry possible, often needs the customer
Customer-facingSafe 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

What are failed payments costing you?

Turn on JavaScript to use the calculator.

Example values only; use your own from your Stripe dashboard. Open the full calculator.

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.