incorrect_zip HTTP 402 Stripe Declines

Stripe Error: incorrect_zip –

When Stripe's payment gateway encounters an invalid or non-existent postal code during a payment processing attempt, it triggers the 'incorrect_zip' error. This occurs at the API level when the provided zip code does not match any known codes in Stripe's database. It is essential to note that this error does not imply a problem with your account or card information but rather an issue with the provided address details.

Official documentation ↗

Root Causes

1.

Invalid Postal Code

The zip code entered might be incorrect, misspelled, or not recognized by Stripe's system.

2.

Non-Existent Address

Stripe may not have a record of the provided address, leading to the error.

Resolution

1.Verify Address Details

Double-check the zip code and ensure it matches the actual location.

2.Update Payment Information

Correct any errors in your payment method's address details within your Stripe account settings or directly on the checkout page.

Code Examples


            stripe.PaymentIntent.create(..., address_zip_code='12345')
          

            stripe.paymentIntents.create({ ... address: { zip_code: '12345' } })
          

            Stripe\PaymentIntent::create([..., 'address' => ['zip_code' => '12345']])
          

            -d "address[zip_code]=12345"

FAQ

What does the 'incorrect_zip' error mean? ▾

It indicates that Stripe's system cannot verify the provided zip code.

How do I fix the 'incorrect_zip' issue? ▾

Verify your address details and update them if necessary.

Independent reference. Always verify against the official Stripe Declines documentation.