ZIP/PIN Code Validation at Checkout for Magento 2

ZIP/PIN Code Validation at Checkout — validate postal codes against configurable country-specific ranges before customers place an order. Ships with pre-loaded ranges for India, US, UK, Canada, Australia, and Europe, a full-featured admin grid, CSV/JSON import-export, and real-time AJAX validation on the storefront.

Panth Zipcode Validation lets merchants restrict checkout to serviceable delivery areas by validating ZIP/PIN codes against configurable country-specific ranges. Out of the box you get pre-loaded range data for India (PIN codes), United States (ZIP codes), United Kingdom (postcodes), Canada, Australia, and major European countries. Admins can extend or override any range through the admin grid, and merchants handling thousands of serviceable pincodes can use CSV/JSON import-export to manage data in bulk. On the storefront, validation runs in real time via AJAX so customers see "out of service area" messages instantly without waiting for full checkout submission.

Whether you're a courier/delivery business limiting to serviceable pincodes in India, a regional retailer restricting shipments to specific US states, or a European merchant validating postcodes per country, Panth Zipcode Validation provides a single configurable engine for all of it.

Get a free quote for your project in 24 hours — custom modules, Hyva themes, performance optimization, M1→M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

• Key Features
• Pre-loaded Country Ranges
• Compatibility
• Installation
• Configuration
• Admin Grid
• CSV / JSON Import-Export
• Real-time AJAX Validation
• FAQ
• Support
• About Panth Infotech
• Quick Links

ZIP / PIN Code Validation Engine

• Country-specific ranges — configure valid postal code ranges per country (e.g., 110000-110099 for Delhi, 90001-90210 for Los Angeles)
• Multiple range types — numeric ranges, alphanumeric patterns (UK, Canada), exact-match lists, and regex patterns
• Pre-loaded country data — India, US, UK, Canada, Australia, and major European countries ready to go
• Allow-list or block-list mode — either restrict to serviceable areas or block specific excluded ranges
• Per-store configuration — different range sets for different store views (useful for multi-country stores)

Admin Grid

• Full-featured UI component grid — search, filter, sort, bulk actions, pagination
• Inline add/edit/delete — manage ranges without page reloads
• Status toggles — enable/disable individual ranges on the fly
• Audit fields — created-at and updated-at timestamps tracked automatically
• Mass actions — enable/disable/delete in bulk

CSV / JSON Import-Export

• Bulk import — upload thousands of pincodes via CSV or JSON in one go
• Bulk export — download all configured ranges for backup or editing offline
• Validation on import — duplicate detection, format checks, clear error messages
• Template downloads — CSV and JSON sample templates provided in admin

Real-time AJAX Validation

• Instant feedback at checkout — customers see validation errors the moment they type a postcode
• Debounced AJAX requests — no server flooding while customers type
• Customizable error messages — configure per-country "We do not deliver to this area" messaging
• Graceful fallback — if AJAX fails, server-side validation still runs on form submit
• Works on both Hyva and Luma — via Panth\Core\Helper\Theme detection

Storefront Behaviour

• Blocks checkout on invalid postcode — customers cannot proceed to payment if postcode is outside serviceable area
• Custom message per country — India, US, UK, etc. each get their own rejection message
• Guest and logged-in support — validation runs for both customer types
• Address book integration — validates postcodes when customers save new addresses too

Security & Performance

• MEQP compliant — passes Adobe's Magento Extension Quality Program
• Indexed lookups — optimized database schema with indexes on country_id and range fields
• Cached country data — pre-loaded ranges cached per store view for fast AJAX response
• Built on Panth Core — reuses shared admin foundation, zero duplication

The module ships with curated postal code range data for the following countries:

You can enable, disable, override, or extend any country dataset from the admin grid.

Composer Installation (Recommended)

composer require mage2kishan/module-zipcode-validation
bin/magento module:enable Panth_Core Panth_ZipcodeValidation
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the release ZIP from Packagist or the Adobe Commerce Marketplace
2. Extract to app/code/Panth/ZipcodeValidation/
3. Ensure Panth_Core is also installed (required dependency)
4. Run the same commands as above

Verify Installation

bin/magento module:status Panth_ZipcodeValidation
# Expected output: Module is enabled

After installation, navigate to:

Admin → Panth Infotech → Zipcode Validation
Admin → Stores → Configuration → Panth Extensions → Zipcode Validation

Settings live under Stores → Configuration → Panth Extensions → Zipcode Validation:

Access the admin grid at Panth Infotech → Zipcode Validation → Ranges:

• Search by country, range start, range end, or label
• Filter by country, status, or date
• Sort any column ascending/descending
• Inline edit labels and status
• Bulk enable/disable/delete with mass actions
• Full keyboard navigation
• Exports respect current filters (export only what you searched)

Import

1. Go to Panth Infotech → Zipcode Validation → Import
2. Download the CSV or JSON template
3. Fill in your pincode/ZIP ranges
4. Upload the file — the module validates format, detects duplicates, and reports errors per row

CSV format:

country_id,range_start,range_end,label,status
IN,110000,110099,Delhi,1
IN,400001,400099,Mumbai,1
US,90001,90210,Los Angeles,1
US,10001,10099,Manhattan,1

JSON format:

[
 {"country_id": "IN", "range_start": "110000", "range_end": "110099", "label": "Delhi", "status": 1},
 {"country_id": "US", "range_start": "90001", "range_end": "90210", "label": "Los Angeles", "status": 1}
]

Export

Click Export → CSV or Export → JSON from the ranges grid. Current grid filters are respected, so you can export only the rows you care about.

When a customer types a postcode in the shipping address form, the storefront JS debounces keystrokes and fires an AJAX request to the validation endpoint (/panth_zipcode/validate/check). The server responds with either:

• {"valid": true} — postcode is in a serviceable range
• {"valid": false, "message": "Sorry, we do not deliver to this area."} — postcode is invalid for the selected country

The form shows an inline error under the postcode field and, if Block Checkout on Invalid is enabled, the "Next" / "Place Order" button is disabled until the customer enters a serviceable postcode.

Validation is theme-aware — on Hyva storefronts the module uses Alpine.js, on Luma it uses Knockout.js, detected via Panth\Core\Helper\Theme.

Does this work with default Magento checkout?

Yes. The module hooks into the core checkout shipping-address step on both Luma (Knockout) and Hyva (Alpine). No checkout rewrites required.

Can I validate only for specific countries?

Yes. In configuration, select which countries should be validated. Unlisted countries skip validation entirely (customers from those countries can check out normally).

Can I use allow-list for India and block-list for US simultaneously?

The global mode setting applies to all countries by default. For per-country logic, use allow-list ranges — any country that has at least one range defined uses allow-list semantics automatically.

Does the module work for B2B / custom checkouts?

Yes, as long as the checkout collects a postcode field in a standard Magento address form. Custom checkout UIs may need minor JS integration.

Can I import 50,000+ pincodes?

Yes. The CSV importer processes rows in chunks. For very large imports (100k+), we recommend running via CLI to avoid admin session timeouts.

Does it slow down checkout?

No. Validation lookups are indexed and cached per country/store view. Typical AJAX response time is under 30ms.

Does it support multi-store?

Yes. Ranges can be scoped to website/store view, so different store views can have different serviceable areas.

Is the source code available?

Yes. The source is on GitHub at github.com/mage2sk/module-zipcode-validation.

Response time: 1-2 business days.

Need Custom Magento Development?

Built and maintained by Kishan Savaliya — kishansavaliya.com — a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency specializing in high-quality, security-focused extensions and themes for both Hyva and Luma storefronts. Our extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management — over 34 modules built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full catalog on the Adobe Commerce Marketplace or Packagist.

• Website: kishansavaliya.com
• Get a Quote: kishansavaliya.com/get-quote
• Upwork Profile (Top Rated Plus): upwork.com/freelancers/~016dd1767321100e21
• Upwork Agency: upwork.com/agencies/1881421506131960778
• Packagist: packagist.org/packages/mage2kishan/module-zipcode-validation
• GitHub: github.com/mage2sk/module-zipcode-validation
• Adobe Marketplace: commercemarketplace.adobe.com
• Email: kishansavaliyakb@gmail.com
• WhatsApp: +91 84012 70422

Ready to upgrade your Magento 2 checkout?

SEO Keywords: magento 2 zipcode validation, pin code validation, postal code validation, india pincode magento, delivery area validation, magento 2 checkout zipcode, magento 2 serviceable area, magento 2 pincode checker, magento 2 zip code restriction, magento 2 postcode validator, india pincode checkout magento, us zip validation magento, uk postcode checkout, canada postal code magento, australia postcode magento, european postcode validation, magento 2 ajax postcode, real-time zipcode check, magento 2 delivery restriction, courier serviceable pincode, magento 2 shipping restriction by pincode, panth zipcode validation, panth infotech, hire magento developer, top rated plus upwork, kishan savaliya magento, mage2kishan, mage2sk, magento marketplace developer, custom magento development india, magento 2 hyva development, magento 2.4.8 module, php 8.4 magento, magento 2 checkout optimization