Magento 2 USPS Shipping Extension, Live Rates, Labels & Tracking

Please Note: The Magento 2 USPS REST API Shipping Extension for Adobe Commerce is independently developed by EcomPlugins. It is not created, endorsed, maintained, or supported by the United States Postal Service.

The Magento 2 USPS REST API Shipping Extension for Adobe Commerce connects your Magento store with USPS APIs for real-time shipping rates, advanced packaging, shipping labels, tracking, and shipment management.

USPS rates are calculated using the warehouse origin, customer destination, package weight, product dimensions, packaging configuration, and available USPS services. Rates can be displayed on the shopping cart, checkout, and Magento Admin order creation pages.

Configure your warehouse origin under Admin → Stores → Configuration → Sales → Shipping Settings.

USPS REST API & OAuth: The extension uses the latest USPS REST API and OAuth access-token authentication. Create an application through the USPS Developer Portal to obtain the Client ID, Client Secret, and other account information required by the enabled USPS APIs.

USPS Address API: Address validation is a separate USPS API service. Access, approval, licensing, usage restrictions, and fees may differ from USPS pricing, label, and tracking APIs.

Why Choose the EcomPlugins USPS Shipping Extension?

Magento 2 and Adobe Commerce include standard USPS functionality in supported configurations, but many merchants require additional control over package calculations, product dimensions, multi-package orders, oversized products, rate adjustments, Admin-only shipping methods, labels, and tracking.

The EcomPlugins USPS extension adds advanced product-level and store-level shipping controls for more complex ecommerce and warehouse requirements.

Default Magento USPS vs EcomPlugins USPS Extension

Magento 2 USPS Shipping Extension Features

• Connect Magento 2 and Adobe Commerce with the latest USPS REST API.
• Use USPS OAuth Client ID and Client Secret authentication.
• Automatically request and manage USPS API access tokens.
• Display real-time USPS rates on cart and checkout pages.
• Retrieve USPS rates during Magento Admin order creation.
• Disable USPS rates on the storefront while keeping them available for Admin orders.
• Configure minimum and maximum order weight rules.
• Configure maximum package weight.
• Automatically split heavy orders into multiple packages.
• Configure product-level length, width, and height.
• Use product dimensions in applicable USPS rate requests.
• Configure product-level box or pack quantity.
• Ship selected products separately.
• Handle oversized and over-dimensional packages.
• Add fixed or percentage shipping-rate markups.
• Display applicable account-based rates returned by USPS.
• Offer free shipping based on subtotal, cart rules, or product configuration.
• Configure custom messages when USPS rates are unavailable.
• Cache applicable USPS API requests.
• Create USPS shipping labels from Magento Admin.
• Add USPS tracking numbers to Magento shipments.
• Retrieve applicable shipment status through the USPS Tracking API.

Advanced USPS Packaging & Multi-Package Shipping

Accurate package information is important when calculating USPS rates. The extension provides product-level and store-level controls for package weight, dimensions, box quantities, and separately packed products.

• Configure maximum package weight.
• Split qualifying orders into multiple packages.
• Configure product-level length, width, and height.
• Use product dimensions in applicable rate requests.
• Define how many product units fit inside one shipping box.
• Calculate the required number of boxes from ordered quantity.
• Ship selected products as separate packages.
• Handle products exceeding configured dimension limits.
• Hide USPS methods when a package is not eligible.

Maximum Package Weight & Oversized Products

USPS weight and dimension limits depend on the selected service, destination, and package type. The extension allows you to configure package limits appropriate for your USPS shipping workflow.

When an order exceeds the configured maximum package weight, qualifying shipments can be divided into multiple packages and the returned package costs combined into the final shipping rate.

USPS Shipping Markup & Free Shipping

• Add a fixed amount to returned USPS shipping rates.
• Add a percentage markup to USPS rates.
• Offer free shipping based on order subtotal.
• Support qualifying Magento cart price rules.
• Configure product-level free shipping.

USPS Address Validation

The USPS Address API can validate and standardize eligible domestic addresses. This service is separate from USPS pricing, label, and tracking APIs and may require additional registration, authorization, licensing, or payment directly through USPS.

Important: Access to USPS address data is not automatically included with every USPS developer account. Review current USPS Address API requirements before enabling this functionality.

USPS Shipping Labels & Tracking

Create eligible USPS shipping labels directly from Magento Admin and associate USPS tracking numbers with Magento shipments.

• Create USPS shipping labels from Magento Admin.
• Generate labels for eligible USPS services.
• Associate tracking numbers with Magento shipments.
• Retrieve applicable USPS package status.
• Provide customers with shipment tracking information.

Shipping-label availability depends on the USPS APIs, services, payment accounts, permissions, and credentials enabled for your USPS account.

USPS API Request Caching

The extension can cache applicable USPS rate requests to reduce duplicate API calls when the same cart, package, and destination information is requested repeatedly.

• Reduce duplicate USPS API requests.
• Reduce unnecessary OAuth and pricing calls.
• Improve shipping-rate response performance.
• Refresh rates when relevant shipment information changes.

USPS Account & REST API Configuration

Create or use an existing USPS account and register an application through the USPS Developer Portal.

Depending on the USPS services used, configuration can include the REST API Client ID, Client Secret, USPS account information, Mailer ID, payment information, warehouse origin, package settings, allowed USPS methods, markup, and free-shipping settings.

The exact credentials and permissions depend on the USPS APIs enabled for your account. Pricing, labels, tracking, address validation, and payment services may have different requirements.

Magento 2 & Adobe Commerce Compatibility

The extension is developed for Magento 2 and Adobe Commerce. Compatibility can depend on your Magento version, PHP version, installed patches, checkout customizations, third-party shipping modules, and other store customizations.

If your store uses a heavily customized checkout, Hyvä Checkout, headless storefront, marketplace extension, custom order-management system, or another USPS shipping customization, please contact us before purchasing.

Installation, Updates & Support

For installation, USPS REST API configuration, rate troubleshooting, labels, tracking, packaging, or custom Magento shipping requirements, contact us at [email protected].

Demo

• Frontend Demo: https://magento2.ecomplugins.com/
• Backend Demo: https://magento2.ecomplugins.com/admin/