incorrect_zipThe postal code is wrong
Stripe's incorrect_zip decline means the billing postal code didn't match. Ask the customer to re-enter it. Retry and messaging guidance.
- Next step
- Customer should correct their card details
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does incorrect_zip mean?
The postal code is incorrect.
Stripe recommends collecting the CVC and postal code at checkout to avoid declines from suspected fraud, so a postal code mismatch is worth fixing rather than dropping the field.
What Stripe says to do
The customer needs to try again with the correct billing postal code.
What to tell the customer
You can tell the customer the postal code didn't match. Ask for the code tied to the card's billing address, which may differ from their shipping address.
The postal code didn't match the one your bank has for this card. Please enter your billing postal code and try again.
Should you retry incorrect_zip?
Yes, after the customer corrects the postal code. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.
Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.
Where incorrect_zip shows up
On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.
Stripe also documents incorrect_zip as a top-level API error code, so check error.code as well as decline_code when you handle it.
Get failed payments in Slack
ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as incorrect_zip, and follow up from there.