incorrect_address
The address the customer entered doesn't match.
| Group | Wrong or invalid card details |
|---|---|
| Retry | Retry won't fix it |
| Customer-facing | Safe 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
- Retrying the same card details won't fix this. Send the customer a card-update link right away.
- Keep the message short and neutral: the payment didn't go through, here's a secure link to update the card.
- Keep the subscription active for a short grace period while they update.
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
- expired_card
- incorrect_cvc
- incorrect_number
- incorrect_zip
- invalid_cvc
- invalid_expiry_month
- invalid_expiry_year
- invalid_number
- All decline codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.