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

Please Note: The Magento 2 UPS Shipping REST API Extension is independently developed by EcomPlugins. It is not created, endorsed, or supported by UPS. This downloadable Magento 2 extension connects Magento Open Source and Adobe Commerce stores with official UPS REST APIs for live shipping rates, advanced packaging calculations, label creation, tracking, and shipment management.

The extension is designed for merchants who need more control and flexibility than Magento’s standard UPS shipping integration. It adds advanced packaging rules, product-level dimensions, multi-package rating, shipping markups, free-shipping conditions, residential address detection, API caching, detailed logging, and additional checkout controls.

UPS shipping rates are calculated using the warehouse origin, customer destination, package weight, product dimensions, packaging configuration, residential or commercial status, and enabled UPS services. The extension sends this shipment information directly to UPS and displays the available live rates during checkout.

To configure your warehouse origin, navigate to Admin → Stores → Configuration → Sales → Shipping Settings. The configured origin address is used as the shipment starting point when requesting rates from UPS.

The extension supports packages weighing up to the limits allowed by UPS. When the total shipment exceeds the configured maximum package weight, the module can automatically divide the order into multiple packages and request combined shipping rates.

UPS REST API and OAuth 2.0: This extension supports the latest UPS REST API authentication flow. You must create an application through the UPS Developer Portal and generate a Client ID and Client Secret. These credentials are entered in Magento Admin and used to generate secure OAuth 2.0 access tokens.

Supported Platforms: Magento Open Source and Adobe Commerce 2.3.x and 2.4.x. Compatibility may depend on the installed PHP version, checkout customizations, and other shipping modules.

Why Choose the EcomPlugins Magento 2 UPS Extension?

Magento includes a basic UPS carrier integration, but many merchants require more advanced control over rates, packaging, labels, product dimensions, and checkout behavior. The EcomPlugins extension extends the standard UPS workflow with features designed for real-world shipping operations.

• Official UPS REST API integration with OAuth 2.0 authentication.
• Real-time UPS shipping rates during checkout and admin order creation.
• Advanced multi-package and product-level packaging logic.
• Product dimensions and custom box or pack-size support.
• Residential and commercial address detection.
• Negotiated UPS account rates.
• Shipping labels generated from Magento Admin.
• Automatic tracking number creation and customer tracking.
• Fixed or percentage-based shipping markups.
• Advanced free-shipping conditions.
• Minimum and maximum order-weight controls.
• API response caching and detailed debug logs.
• Direct support from Magento shipping specialists.

EcomPlugins UPS Extension vs Magento Default UPS Integration

Note: Magento’s default functionality can vary by version and configuration. The comparison above focuses on the additional controls and operational features provided by the EcomPlugins extension.

UPS Shipping Services Supported

The module displays the UPS shipping services available for the configured origin, destination, package details, and UPS account. Depending on account eligibility and shipment details, supported services may include:

• UPS Ground
• UPS Ground Saver
• UPS SurePost
• UPS 3 Day Select
• UPS 2nd Day Air
• UPS 2nd Day Air A.M.
• UPS Next Day Air
• UPS Next Day Air Early
• UPS Next Day Air Saver
• UPS Worldwide Express
• UPS Worldwide Express Plus
• UPS Worldwide Expedited
• UPS Worldwide Saver
• UPS Standard

Only services returned by the UPS API for the current shipment will be displayed during checkout.

Real-Time UPS Shipping Rates

The extension sends shipment details directly to UPS and retrieves real-time shipping rates based on your UPS account and package configuration.

The rate request may include:

• Warehouse origin address.
• Customer shipping address.
• Residential or commercial delivery status.
• Total shipment weight.
• Individual product dimensions.
• Package type.
• Number of packages.
• Declared value and applicable shipment settings.
• Negotiated account-rate preferences.

UPS returns the eligible shipping methods and prices, which Magento displays during checkout or admin order creation.

Advanced Packaging and Multi-Box Logic

Accurate shipping rates depend heavily on accurate packaging. The EcomPlugins extension offers additional packaging controls for merchants whose products cannot be rated correctly using a single combined order weight.

Automatic Package Splitting

When the shipment exceeds the configured maximum package weight, the extension can automatically divide the order into multiple packages. UPS rates each package, and Magento displays the combined shipping charge.

Product-Level Dimensions

Length, width, height, and weight can be defined at the product level. These values help generate more accurate dimensional and package-based shipping rates.

Product-Level Box or Pack Quantity

Merchants can define how many units fit inside a shipping box or pack. For example, if one box holds ten units and the customer orders twenty-five units, the extension can calculate the required number of packages based on the configured pack quantity.

Ship Separately

Products marked to ship separately are sent to UPS as individual packages. This is useful for fragile, oversized, irregular, or manufacturer-packed products.

Oversized Package Controls

The extension can manage products that exceed configured dimension or weight limits. Depending on your settings, it can request applicable UPS rates, use alternative packaging logic, or hide UPS methods when the shipment is not eligible.

Residential and Commercial Address Detection

UPS may charge different rates for residential and commercial deliveries. Incorrect classification can cause inaccurate checkout rates and unexpected residential surcharges after shipment processing.

The module can use the UPS Address Validation API to determine whether the customer’s destination is residential or commercial before requesting rates. If the API does not return a classification, the module uses the default value configured in Magento Admin.

Merchants requiring a dedicated address-type solution can also review the Magento 2 UPS Residential and Commercial Address Checker.

For full customer address standardization and suggested-address selection, see the Magento 2 UPS Checkout Address Validation extension.

Negotiated UPS Account Rates

Merchants with negotiated UPS pricing can enable account-level discounted rates. When supported by the UPS account and API response, customers will see shipping prices based on the merchant’s negotiated UPS agreement rather than only published retail rates.

This helps businesses pass discounted shipping rates to customers or apply a configurable markup before displaying the final checkout price.

Shipping Markups and Handling Charges

The extension allows merchants to adjust UPS shipping rates before displaying them to customers.

• Add a fixed amount to the returned shipping rate.
• Add a percentage markup to the rate total.
• Use markup to cover packaging, insurance, labor, or handling expenses.
• Apply a consistent shipping pricing strategy across UPS services.

Free Shipping Rules

Merchants can configure free-shipping conditions while continuing to use UPS rate calculations for other orders.

• Free shipping based on order subtotal.
• Free shipping based on configured cart conditions.
• Product-level free-shipping support.
• Combine free-shipping products with normally rated items.
• Control which UPS method is used for qualifying orders.

Checkout and Rate Display Controls

• Enable or disable UPS rates on storefront checkout.
• Keep UPS rates available for Magento Admin order creation.
• Set minimum order weight for storefront UPS rates.
• Set a separate minimum order weight for admin order rates.
• Set a maximum order weight for UPS availability.
• Show or hide estimated delivery days.
• Display custom error messages when UPS does not return rates.
• Hide unavailable or restricted UPS services.
• Support guest and registered-customer checkout.

UPS Shipping Labels

The extension allows administrators to create UPS shipping labels directly from Magento Admin. Shipment and package details are sent to UPS, and the returned label can be used by the fulfillment team.

• Create UPS shipments from Magento Admin.
• Generate UPS shipping labels.
• Create tracking numbers during shipment processing.
• Associate tracking details with Magento shipments.
• Provide shipment tracking information to customers.
• Reduce manual entry between Magento and UPS systems.

Shipment Tracking

Tracking information created during shipment processing is saved in Magento and can be made available to customers through order emails and the customer account area.

This creates a more streamlined fulfillment workflow and reduces the need to manually copy tracking numbers between UPS and Magento.

API Request Caching and Performance

Repeated shipping-rate requests can increase checkout latency and consume unnecessary API resources. The module includes request caching to reduce duplicate calls when the same cart and destination details are submitted repeatedly.

• Cache qualifying rate requests.
• Cache OAuth access tokens.
• Reduce duplicate UPS API authentication calls.
• Improve checkout response time.
• Reduce unnecessary external API traffic.

Logging and Troubleshooting

Detailed logging helps merchants and developers diagnose rate, authentication, address, and packaging issues.

• Enable or disable API logging from Magento Admin.
• Review UPS request data.
• Review UPS response data.
• Identify OAuth authentication errors.
• Troubleshoot missing shipping methods.
• Review package weights and dimensions sent to UPS.

Sensitive credentials should be excluded or masked in production logs.

Configuration

Complete the following steps to configure the extension:

1. Create or log in to your UPS Developer account.
2. Create an application with access to the required UPS APIs.
3. Generate your Client ID and Client Secret.
4. Install and enable the EcomPlugins UPS extension.
5. Enter the UPS REST API credentials in Magento Admin.
6. Configure your warehouse origin under Stores → Configuration → Sales → Shipping Settings.
7. Select the allowed UPS shipping methods.
8. Configure negotiated-rate, residential, packaging, and weight settings.
9. Enable logging while testing the integration.
10. Clear Magento configuration and full-page cache.
11. Test rates using multiple addresses, weights, dimensions, and cart combinations.

UPS Account and Pricing

A UPS account and valid UPS Developer API credentials are required. For the current REST API integration, configure the Client ID and Client Secret created through the UPS Developer Portal.

Legacy UPS Username, Password, and Access License Number credentials apply only to older XML-based integrations and should not be used for the current OAuth 2.0 REST API configuration unless a legacy version of the extension is installed.

Standard UPS shipping charges apply according to your UPS account and negotiated agreement.

Extension updates and support are available for $99.95 per year after the first year.

User Guide: FedEx and UPS Packaging Logic with REST API Plugin Flow

Who Should Use This Extension?

• Magento stores that require UPS REST API and OAuth 2.0 integration.
• Merchants that need more packaging control than Magento’s default UPS carrier.
• Businesses shipping products with individual dimensions.
• Stores that regularly divide orders into multiple boxes.
• Merchants using negotiated UPS account rates.
• Warehouses creating UPS labels directly from Magento.
• Stores requiring residential or commercial address detection.
• Businesses that need custom shipping markups or free-shipping conditions.
• Magento and Adobe Commerce stores requiring detailed UPS API logs.

Benefits for Magento Merchants

• Display accurate UPS shipping rates during checkout.
• Reduce undercharging caused by inaccurate package calculations.
• Reduce unexpected residential and dimensional surcharges.
• Automate multi-package rate calculations.
• Reduce manual shipment and label processing.
• Use negotiated UPS rates within Magento.
• Improve fulfillment accuracy.
• Offer customers more reliable shipping choices.
• Manage rates, packaging, labels, and tracking from Magento.

Frequently Asked Questions

Does this extension support the UPS REST API?

Yes. The extension supports the UPS REST API with OAuth 2.0 authentication using a Client ID and Client Secret.

How is this different from Magento’s default UPS integration?

The extension adds advanced product-level dimensions, multi-package calculations, box or pack quantities, ship-separately options, residential address detection, labels, tracking, rate markups, API caching, weight controls, and detailed logging.

Does it support negotiated UPS rates?

Yes. Negotiated account rates can be requested when they are enabled and available for your UPS account.

Can it divide an order into multiple UPS packages?

Yes. The extension can divide shipments based on maximum package weight, product packaging settings, configured box quantities, and ship-separately rules.

Can I define product dimensions?

Yes. Product-level length, width, height, and weight values can be used when building package requests.

Can each product be shipped separately?

Yes. Products configured to ship separately can be submitted to UPS as individual packages.

Does the extension create UPS shipping labels?

Yes. UPS labels and tracking numbers can be generated during shipment creation in Magento Admin.

Can I add a markup to UPS rates?

Yes. You can add either a fixed amount or a percentage-based markup to the UPS rate returned during checkout.

Can I offer free UPS shipping?

Yes. Free shipping can be configured using order-subtotal rules, cart conditions, and product-level settings.

Can UPS rates be hidden on the storefront but used in Magento Admin?

Yes. The extension can disable frontend UPS rates while keeping them available during Magento Admin order creation.

Does the module detect residential addresses?

Yes. When enabled and supported by your UPS account, the module can use UPS Address APIs to determine whether the destination is residential or commercial.

Does it support Magento 2.4.x?

Yes. The extension supports Magento Open Source and Adobe Commerce 2.4.x releases. Confirm compatibility with your exact Magento and PHP version before installation.

Related Magento Shipping Extensions

• Magento 2 UPS Residential and Commercial Address Checker – Automatically detect address type before calculating UPS rates.
• Magento 2 UPS Checkout Address Validation – Validate and standardize customer shipping addresses during checkout.
• Magento 2 FedEx Shipping REST API – Display live FedEx shipping rates and manage FedEx shipments.
• Magento 2 USPS Shipping REST API – Integrate live USPS rates, services, and shipment features.
• Magento Shipping Integration – Explore UPS, USPS, FedEx, LTL freight, and custom carrier integrations.
• Magento Address Validation – Compare address validation solutions for Magento and Adobe Commerce.

Why Choose EcomPlugins?

• Specialists in Magento and Adobe Commerce shipping extensions.
• Practical features developed around real merchant and warehouse requirements.
• Direct technical support from experienced Magento developers.
• Regular updates for carrier API and Magento compatibility changes.
• Custom development and integration support available when required.

Support

For assistance with installation, UPS REST API credentials, OAuth configuration, packaging rules, rate troubleshooting, or extension compatibility, please contact the EcomPlugins support team.

Contact EcomPlugins or email [email protected].

Additional Information

The Magento 2 UPS Shipping REST API Extension is suitable for merchants who want to offer cost-effective UPS Ground services while also supporting expedited and international UPS shipping methods.

Its advanced packaging, rate-calculation, address-detection, label, tracking, and checkout features make it a stronger operational solution for stores that have outgrown Magento’s basic UPS carrier configuration.