IPA – Indian Pincode Autofill

Description

IPA – Indian Pincode Autofill streamlines the WooCommerce checkout process for Indian e-commerce stores. When a customer enters a valid 6-digit Indian PIN code at checkout, the plugin instantly detects the corresponding city and state, and autofills the respective fields without disrupting the customer’s typing focus.

By reducing checkout friction and eliminating typos in city and state names, this plugin significantly increases checkout conversion rates and prevents delivery failures caused by mismatched address details.

Why Choose IPA?

  • Lightning-Fast Autofill: Detects location within milliseconds as soon as 6 digits are typed.
  • Intelligent Debouncing (500ms): Eliminates duplicate requests while typing.
  • High-Performance Transients Caching: Caches verified PIN codes in WordPress Transients for 30 days to ensure instantaneous lookup and minimal API load.
  • Country-Specific Checkout Ordering: Intelligently reorders checkout fields for India (PIN Code -> City -> District -> State) using WooCommerce’s native locale filter, leaving all other countries 100% untouched.
  • Dedicated District Field Support: Optionally display a dedicated District checkout field with toggleable autofill and customer edit/lock controls.
  • Configurable City Value Source: Choose between “District as City” (courier & logistics standard) or “Smart Town Mode” (filters out bazaar and neighborhood street names).
  • Zero Impact on International Orders: The plugin operates strictly when the selected country is India (IN). For US, UK, EU, or any non-Indian checkout, the plugin remains completely inactive.
  • Seamless Compatibility: Works with standard WooCommerce checkout, WooCommerce Gutenberg Blocks, AJAX fragments refresh, One Page Checkout plugins, and modern themes.
  • Dedicated Admin Settings: Separate admin menu with toggle switches for enabling/disabling the plugin, toggling city, district, and state autofill, locking fields as readonly, or reordering checkout fields.
  • Live PIN Code Tester: Test any PIN code directly in the WordPress admin to inspect live API results, cached responses, and state codes.
  • 100% HPOS Ready: Fully compatible with WooCommerce High-Performance Order Storage (HPOS).
  • Accessible & Secure: Built using WordPress Coding Standards (WPCS), strict nonces, input sanitization, and output escaping.

External services

This plugin relies on a 3rd-party external API service to verify and resolve Indian PIN codes into geographical locations:

  • Service Name: Postal Pincode API
  • Provider URL: https://api.postalpincode.in/
  • Service Purpose: Resolves a 6-digit Indian postal code (PIN) into its respective District (City) and State name.
  • Data Transmitted: Only the 6-digit numeric PIN code entered by the user (e.g. 302001). No personal information, names, email addresses, street addresses, phone numbers, or IP addresses are ever transmitted or stored remotely.
  • When Data is Transmitted: An outbound HTTPS GET request is made exclusively when a customer enters exactly 6 digits into the billing or shipping postcode field and the selected country is India (IN).
  • Terms of Service: https://api.postalpincode.in/
  • Privacy Policy: https://api.postalpincode.in/

Screenshots

Installation

  1. Upload the ipa-indian-pincode-autofill folder to the /wp-content/plugins/ directory, or install the plugin directly through the WordPress Plugins screen.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Ensure WooCommerce is installed and activated.
  4. Navigate to your checkout page, select India as the country, and type any valid 6-digit PIN code (e.g. 110001 or 400001). City and State will autofill automatically!

FAQ

Does this plugin affect international customers?

No. The plugin has zero effect on non-Indian checkouts. If a customer selects any country other than India (such as the United States, United Kingdom, Australia, Canada, etc.), the plugin will not send requests or modify any checkout fields.

What happens if the customer enters an invalid PIN code?

The plugin validates the response from the postal database. If an invalid or unallocated PIN code is entered, an inline notification appears under the PIN code field, allowing the customer to correct it or enter their address manually without intrusive alert popups.

Is WooCommerce HPOS supported?

Yes! The plugin explicitly declares compatibility with WooCommerce High-Performance Order Storage (HPOS) and follows modern WooCommerce architecture standards.

Does this slow down the checkout page?

Not at all. JavaScript and CSS assets are enqueued strictly on checkout and cart pages. All network requests use 500ms debouncing and 30-day transient caching.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“IPA – Indian Pincode Autofill” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release.
  • Automated Indian PIN code detection and autofill for City, District, and State at WooCommerce checkout.
  • Support for dedicated District checkout field with independent autofill and lock controls.
  • Configurable “City Value Source” setting (“District as City” or “Smart Town Mode”).
  • Dedicated admin dashboard with tabbed navigation, live PIN code tester, and one-click AJAX cache purge.
  • 30-day transient caching layer for instantaneous lookups.
  • Full WooCommerce High-Performance Order Storage (HPOS) compatibility.
  • Compatible with standard WooCommerce Classic checkout and WooCommerce Blocks checkout.