Decline Decoder

incorrect_address

The address the customer entered doesn't match.

GroupWrong or invalid card details
RetryRetry won't fix it
Customer-facingSafe to explain

What it means

The address the customer entered doesn't match.

What Stripe's docs suggest

Ask the customer to try again with the correct address. Source

Will a retry work?

Stripe can retry this code, but retrying the same wrong details won't help. The customer has to correct or replace the card.

What to tell the customer

A message you could send: “Your payment didn't go through because some card details didn't match. Please re-enter your card using this secure link.”

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 incorrect_address mean?

The address the customer entered doesn't match.

Can I retry a incorrect_address decline?

Stripe can retry this code, but retrying the same wrong details won't help. The customer has to correct or replace the card.

What should I tell a customer about incorrect_address?

A message you could send: “Your payment didn't go through because some card details didn't match. Please re-enter your card using this secure link.”

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.