Skip to content

Free tools / Stripe decline codes / incorrect_address

Stripe decline code: incorrect_address

incorrect_address is one of the decline codes Stripe returns when a card payment fails, in last_payment_error.decline_code on the PaymentIntent or outcome.reason on the Charge. Stripe's label for it is "Incorrect address". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.

Abderrahim Ben Jazia, PhDBy · Founder of FlowMRR, previously built and sold AIS (Avance Immédiate Services), French tax-credit softwareChecked against Stripe's docs:
Decline code
incorrect_address
Type
Card update needed
Who can fix it
The customer — needs to act
Will a retry help?
No: do not retry

What it means

The billing address entered does not match the one the bank has on file.

Card update needed. The card on file is expired, wrong or closed. Retrying will fail every time; only the customer can replace it.

Should you retry?

No: do not retry. No. The bank will refuse the same card as is, or Stripe or the network asked not to try again. Retrying wastes an attempt and can breach the card networks' reattempt rules. Change what is wrong, or ask for another card.

Recommended action

Who can fix it: The customer — needs to act. Ask the customer to check their billing address and pay again.

What to tell the customer

Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.

The billing address does not match the one your bank has on file. Please check it and pay again.

Customer email template

Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.

Hi {name},

The payment for {product} didn't go through because the billing address didn't match the one your bank has on file. Please check it and pay here: {link}

Thanks,
{company}

Stripe's documentation

Stripe lists this code, with its advice for the customer, in its decline codes reference. The data on this page was last checked against it on 12 November 2026.

Related decline codes

Codes that behave the same way, to read next.

Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk.

Try FlowMRR free
Contact us
FlowMRR

Let's talk

A question, a technical issue or an idea for a partnership? Write to the FlowMRR team.