Kodea - Store Pickup

Store Pickup adds a complete store-level pickup workflow for Adobe Commerce and Magento Open Source. It helps merchants offer customers a convenient pickup option at checkout while giving administrators full control over pickup locations, store-view availability, contact details, and locator behavior.

The extension includes pickup-location management, a checkout pickup selector, a standalone store locator page, optional Google Maps integration, quote-to-order pickup data transfer, a fixed-rate pickup shipping method, and a read-only public API for pickup-location discovery.

Key Features

• Pickup location admin management: Create and manage pickup locations directly from the Magento Admin. 
• Store-view assignment: Assign each pickup location to specific store views for multi-store and multi-country storefronts. 
• Checkout pickup selector: Let customers choose a pickup location during checkout when the pickup shipping method is selected. 
• Pickup contact fields: Capture pickup person name and phone number during checkout. 
• Built-in fixed-rate pickup carrier: Includes a configurable pickup shipping method with title, method name, price, and sort order. 
• Standalone store locator: Provide customers with a searchable pickup-location page outside checkout. 
• Optional Google Maps support: Use Google Maps and Places when an API key is configured, with a list-only fallback when maps are not enabled. 
• Large-location support: Locator search uses server-side pagination, page-size limits, text filtering, store-view filtering, radius filtering, and map-bounds filtering. 
• Quote-to-order data transfer: Pickup information is saved on the quote shipping address and transferred to the order shipping address. 
• Public read-only API: Expose active checkout-enabled pickup locations for a store view through a read-only Web API endpoint. 

Pickup Location Management

Administrators can manage pickup locations from the Magento Admin. Each pickup location can include a stable location code, name, description, active status, checkout-enabled status, sort order, store-view assignment, contact name, email, phone, fax, country, region, city, street, postcode, latitude, and longitude.

Only active and checkout-enabled pickup locations assigned to the current store view are displayed in checkout and locator results.

Checkout Experience

Store Pickup includes a dedicated pickup carrier with the carrier code kodea_storepickup and method code pickup.

When the pickup method is selected, customers are required to choose a pickup location and provide pickup contact details.

The selected pickup location code, pickup person name, and pickup person phone are stored on the quote shipping address and carried through to the order shipping address. This keeps pickup information available for order processing, fulfillment workflows, service contracts, and integrations.

Store Locator

The extension includes a standalone store locator page at:

/store-pickup/locator

Customers can search available pickup locations using text, location filters, radius search, and map-based search when Google Maps is configured.

The locator is designed for large pickup-location catalogs. Results are paginated server-side, and the frontend renders only the current result page as list rows and map markers. This helps avoid loading thousands of store markers into the browser at once.

Google Maps Optional Fallback

Google Maps and Places support can be enabled by adding a browser-restricted Google Maps API key in configuration.

If no API key is configured, the locator still works as a searchable list, so merchants can use the extension without requiring a maps integration.

Configuration Options

• Enable or disable the pickup carrier. 
• Configure carrier title and method name. 
• Set a fixed pickup method price. 
• Control shipping method sort order. 
• Add additional carrier codes that should trigger the pickup selector. 
• Enable or disable the standalone locator page. 
• Configure Google Maps browser API key. 
• Set default locator radius, page size, max page size, and default map center. 

API and Integration Support

The extension provides a read-only Web API endpoint for pickup-location discovery by store view:

GET /V1/kodea/storepickup/locations/:storeId

The response contains active, checkout-enabled pickup locations assigned to the requested store view.

The module also supports extension points for additional pickup carrier codes, frontend filtering, and optional integration modules that may add distance-aware, stock-aware, external API, or routing logic.

MSI Compatibility

Store Pickup is independent from Magento native MSI in-store-pickup modules.

It owns its own pickup-location records, checkout transport fields, quote-to-order propagation, Web API, store locator, and carrier behavior.

This makes the extension usable on Magento installations where MSI is enabled without requiring the native MSI in-store-pickup module stack.

Compatibility

• Adobe Commerce and Magento Open Source 2.4.6 and newer in the 2.4 line. 
• PHP 8.1, 8.2, 8.3, and 8.4. 
• Composer-managed Magento installations. 
• Multi-store and multi-country storefronts. 

Typical Use Cases

• Retailers that want customers to buy online and pick up orders in store. 
• Merchants with multiple branches, showrooms, pickup counters, warehouses, or service locations. 
• Multi-store Magento projects that need pickup locations assigned by store view. 
• Stores that need a pickup workflow without depending on Magento native MSI in-store-pickup modules. 
• Businesses that want a searchable pickup-location page with optional Google Maps support. 

Benefits

• Improves checkout flexibility by adding a store-pickup delivery option. 
• Gives administrators structured control over pickup-location data. 
• Supports large location catalogs with bounded, paginated search results. 
• Keeps pickup information available on orders for fulfillment and integrations. 
• Works with or without Google Maps configuration. 
• Supports multi-store storefronts through store-view pickup-location assignment.