incorrect_zip
The billing postal code is wrong.
| Group | Wrong or invalid card details |
|---|---|
| Retry | Retry won't fix it |
| Customer-facing | Safe to explain |
What it means
The billing postal code is wrong.
What Stripe's docs suggest
Have the customer re-enter the ZIP or postal code their bank has on file. 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_zip mean?
The billing postal code is wrong.
Can I retry a incorrect_zip 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_zip?
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_address
- incorrect_cvc
- incorrect_number
- 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.