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

Please Note: The Magento 2 USPS Shipping Extension with REST API is independently developed by EcomPlugins. It is not created, endorsed, maintained, or supported by the United States Postal Service. This extension connects Magento 2 and Adobe Commerce stores with USPS APIs and provides advanced shipping features beyond the standard Magento USPS carrier configuration.

USPS provides domestic and international mailing and parcel-delivery services. USPS is commonly used by ecommerce merchants for lightweight and small-package shipping through services such as USPS Ground Advantage, Priority Mail, Priority Mail Express, Media Mail, and eligible international mail services.

The Magento 2 USPS Shipping Extension retrieves real-time USPS shipping rates and displays available services on the shopping cart, checkout, and Magento Admin order creation pages. Shipping rates are calculated using the seller’s origin address, customer destination address, package weight, product dimensions, packaging configuration, and USPS services enabled for the merchant account.

Configure the warehouse origin address under Admin → Stores → Configuration → Sales → Shipping Settings. After the origin address and USPS API credentials are configured, the extension sends shipment information to USPS and returns the applicable shipping methods and prices.

This extension supports USPS packages within the weight and dimension limits established for the selected USPS service. Many commonly used USPS parcel services have a maximum package weight of up to 70 lbs, although actual limits may vary by service, destination, package type, and USPS rules.

The extension includes advanced features such as maximum-package-weight splitting, product dimensions, product-level packaging, shipping-rate markup, admin-only rates, oversized-package handling, free-shipping controls, shipping-label generation, shipment tracking, custom error messages, and API request caching.

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

USPS Address API: USPS address validation is a separate API service. Access, licensing, usage restrictions, approval requirements, and fees may differ from the USPS pricing, labels, or tracking APIs. Merchants who enable address validation should review the latest USPS Address API terms directly with USPS.

Why Choose the EcomPlugins USPS Shipping Extension?

Supported Magento and Adobe Commerce versions include a standard USPS carrier integration. However, many merchants require more control over package calculations, product dimensions, rate adjustments, oversized products, admin-only shipping methods, label creation, and multi-package orders.

The EcomPlugins USPS extension adds practical shipping options for merchants whose requirements go beyond the standard Magento USPS configuration. It is designed for stores that need flexible packaging logic, product-level shipping controls, reliable rate calculation, and a more configurable USPS workflow.

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 the shopping cart page.
• Display available USPS shipping methods during checkout.
• Retrieve USPS rates while creating orders in Magento Admin.
• Disable USPS rates on the storefront while keeping them available for Admin orders.
• Enable or disable supported residential-address options.
• Integrate with applicable USPS address services when separately configured and authorized.
• Set a minimum total order weight required to display USPS rates.
• Set a maximum total order weight allowed for USPS rates.
• Configure the maximum weight allowed for each package.
• Automatically divide heavy orders into multiple packages.
• Configure product dimensions including length, width, and height.
• Include product dimensions in USPS rate requests.
• Manage oversized and over-dimensional products.
• Apply a configured rate for oversized packages.
• Hide USPS methods when package dimensions exceed configured limits.
• Offer free shipping based on order subtotal.
• Support Magento shopping-cart price rules.
• Configure free shipping at the individual product level.
• Set a box or pack quantity at the product level.
• Use product box quantity when calculating the required package count.
• Ship selected products separately.
• Request USPS rates for individually packed products.
• Add a fixed amount to the returned USPS shipping rate.
• Add a percentage markup to the returned USPS shipping rate.
• Display discounted or account-based rates when returned by USPS.
• Configure a custom error message when USPS rates are unavailable.
• Cache USPS API requests to reduce unnecessary duplicate calls.
• Create USPS shipping labels from Magento Admin.
• Add USPS tracking numbers to Magento shipments.
• Retrieve shipment status through the USPS Tracking API.

Advanced USPS Packaging Options

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

• Configure a maximum weight for each USPS package.
• Split an order into multiple packages when the package-weight limit is exceeded.
• Configure length, width, and height for individual products.
• Use product dimensions when building the USPS rate request.
• Define how many units can be packed inside one shipping box.
• Calculate the required number of boxes from the product quantity.
• Ship selected products as individual packages.
• Calculate separate package rates and combine the shipping amount.
• Apply special handling to products that exceed configured dimensions.
• Hide USPS shipping methods when a package is not eligible.

Maximum Package Weight and Multi-Package Shipping

Many USPS parcel services support packages weighing up to 70 lbs, but the exact maximum depends on the selected service and shipment details. The extension allows the administrator to define a maximum package weight appropriate for the store’s USPS configuration.

When the combined order weight exceeds the configured package limit, the extension can divide the order into multiple packages and request rates using the resulting package information.

For example, when the maximum package weight is set to 70 lbs and the order weighs 100 lbs, the extension can calculate the shipment using multiple packages instead of sending one unsupported 100-lb package to USPS.

• Set a configurable maximum package weight.
• Prevent unsupported overweight package requests.
• Split eligible orders into multiple packages.
• Combine the returned package costs into the final shipping rate.
• Use product-level packaging rules where configured.

USPS Product Dimensions and Oversized Packages

USPS shipping eligibility and pricing can depend on package dimensions as well as weight. The extension allows merchants to save length, width, and height values at the Magento product level and use those values during rate calculation.

• Set product length.
• Set product width.
• Set product height.
• Include dimensions in applicable USPS API requests.
• Identify packages that exceed configured dimension limits.
• Apply a custom shipping charge for over-dimensional products.
• Hide USPS shipping methods for ineligible packages.

USPS Shipping-Rate Markup

The extension allows merchants to adjust the shipping rates returned by USPS before displaying them to customers. This can help recover packaging, handling, insurance, or warehouse-processing costs.

• Add a fixed amount to each USPS shipping rate.
• Add a percentage markup to each USPS shipping rate.
• Apply the adjustment automatically during rate calculation.
• Display the final adjusted rate during cart and checkout.

For example, a merchant can add a fixed handling fee of $2.00 or apply a percentage markup to the USPS amount returned for the shipment.

USPS Free-Shipping Options

The extension provides several ways to offer free USPS shipping while maintaining control over qualifying orders and products.

• Offer free shipping when the order subtotal reaches a configured amount.
• Support qualifying Magento cart-price rules.
• Configure free shipping for selected products.
• Apply free shipping without disabling paid USPS services for other orders.

USPS Address Validation

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

• Validate eligible domestic addresses through the applicable USPS address service.
• Standardize address details based on USPS data.
• Improve the quality of addresses submitted for shipping calculations.
• Use the configured fallback behavior if the address service is unavailable.

Important: Access to USPS address data is not automatically included with every USPS developer account. Review the latest USPS Address API agreement, approval process, pricing, and usage restrictions before enabling this feature.

USPS Shipping Labels and Tracking

The extension can create USPS shipping labels for Magento orders from the Admin panel. It can also associate USPS tracking numbers with Magento shipments and retrieve current package status through the USPS Tracking API.

• Create USPS shipping labels from Magento Admin.
• Generate labels for eligible USPS services.
• Associate tracking numbers with Magento shipments.
• Retrieve USPS package status.
• Display current tracking information when returned by USPS.
• Provide customers with shipment-tracking information.

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

USPS API Request Caching

Magento checkout can request shipping rates more than once when a customer updates an address, changes the cart, or moves between checkout steps. Repeated requests can increase API traffic and slow down rate calculation.

The extension can cache applicable USPS rate requests to help avoid sending identical requests repeatedly within the configured cache period.

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

Supported Magento Product Types

The extension can calculate USPS shipping rates for common Magento product types when physical shipping information is available.

• Simple products
• Configurable products
• Grouped products
• Bundle products
• Virtual products when included in an order with physical products

Final package calculations depend on the Magento product configuration, selected child products, product weight, dimensions, and packaging settings.

Common USPS Services

The services displayed in Magento depend on the origin address, destination, package weight, dimensions, mail class, merchant account, and services returned by USPS.

• USPS Ground Advantage
• Priority Mail
• Priority Mail Express
• Media Mail, when the shipment is eligible
• Library Mail, when the shipment is eligible
• Parcel Select services, when enabled and available
• First-Class Mail services for eligible mailpieces
• Priority Mail International
• Priority Mail Express International
• Other domestic or international services returned for the configured account

EcomPlugins does not control which services USPS returns. Service availability and pricing are determined by USPS based on the submitted shipment details and merchant-account eligibility.

USPS Account and API Configuration

Create or use an existing USPS account. You must also register and create an application through the USPS Developer Portal.

Enter the required USPS information in the extension configuration:

• USPS REST API Client ID
• USPS REST API Client Secret
• USPS Customer Registration ID or account information, when required
• USPS Mailer ID, when required for the selected service
• USPS payment-account information, when required for labels
• Warehouse origin address
• Maximum package weight
• Allowed USPS shipping methods
• Shipping-rate markup settings
• Free-shipping settings

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

Magento and Adobe Commerce Compatibility

The extension is developed for Magento 2 and Adobe Commerce. Compatibility depends on the extension release, Magento version, PHP version, installed patches, custom checkout, third-party shipping modules, and other store customizations.

Contact EcomPlugins before purchasing when your store uses a heavily customized checkout, marketplace module, multi-vendor workflow, headless storefront, Hyvä Checkout, custom order-management system, or another shipping customization.

Installation, Updates, and Support

EcomPlugins can assist with:

• Magento extension installation
• USPS REST API credential configuration
• Migration from the retired USPS Web Tools APIs
• USPS OAuth access-token troubleshooting
• Missing USPS shipping-rate troubleshooting
• Package-weight and dimension configuration
• Multi-package shipping configuration
• USPS shipping-label setup
• USPS tracking configuration
• Custom USPS shipping requirements

Support

For installation assistance, USPS API configuration, rate troubleshooting, shipping-label issues, or custom Magento shipping requirements, contact the EcomPlugins support team.

Email: [email protected]

Demo

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