Free tools / Stripe decline codes / incorrect_zip
Stripe decline code: incorrect_zip
incorrect_zip 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 ZIP". Here is what it means, whether a retry can succeed, who can fix it, and what to tell the customer.
- Decline code
- incorrect_zip
- 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 postal code did not match the one on file at the bank.
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 the billing address.
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 postal code does not match the one your bank has on file. Please check your billing address.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
The card we have on file for {product} can no longer be charged (it looks expired or invalid). To keep your access, please add a new card 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