ZIP/PIN Code Validation at Checkout for Magento 2

What you get

Key Features

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

Pre-loaded Country Ranges

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.

Admin Grid

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)

CSV / JSON Import-Export

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.

Real-time AJAX Validation

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.

Quick Links

• 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

Compatibility

Installation

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

Configuration

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