Magento 2 USPS Shipping Extension – Real-Time USPS Rates via REST API v3
Live USPS rates via REST API v3
- OAuth2 REST USPS API v3 credentials
- Rate Caching Configurable TTL cache
- Method Control Allowed services and top-N
- Admin Test Tools Connection and sample rates
Live USPS rates via REST v3
USPS legacy Web Tools is being retired and default Magento USPS lacks modern OAuth REST. This extension quotes real-time USPS rates with OAuth2 REST API v3, caching, and checkout controls.
- Real-time rates via USPS REST API v3
- OAuth2 Consumer Key and Secret credentials
- Configurable rate cache to cut repeat API calls
- Service filters, fees, markup, and top-N display
Built for your store
Built for Magento 2.4.x Open Source and Adobe Commerce with PHP 8.1–8.3. Single-origin quoting; configure under USPS REST API (Toweringmedia).
- Magento 2.4.x Open Source and Adobe Commerce
- Sandbox or live mode in carrier settings
- Admin Test Connection and Test Rate tools
- Commercial or retail USPS price type support
How It works
See It In Action
✔ Product updates and support for 12 months
Magento 2 USPS REST API Shipping Extension (OAuth + API v3)
Migrate USPS shipping to the OAuth-secured REST API platform and display real-time USPS rates in cart and checkout. This extension integrates with USPS REST API v3 using OAuth2, with caching and checkout guardrails designed for production traffic.
Short description
- Real-time USPS checkout rates via USPS REST API v3 + OAuth2.
- Built-in rate caching improves checkout speed and reduces API volume on common routes.
- Configurable method filtering, handling fee, markup controls, and optional top-N method output.
- Volume-ready packaging: estimates package dimensions from cart weight (admin defaults apply when weight is 0).
- Admin test tools + optional debug logging for faster setup and troubleshooting.
Important: USPS Web Tools shutdown (migration)
Got a USPS letter about Web Tools? You likely need to migrate. USPS states the legacy Web Tools platform was retired effective January 25, 2026, and availability may be degraded or interrupted at any time.
If your store uses older services like RateV4, IntlRateV2, or TrackV2, moving to the OAuth + REST API platform helps avoid shipping-rate disruption. This extension is built specifically to migrate Magento 2 stores to USPS’s modern API model.
How it works
Rates are calculated from your configured Magento Shipping Origin to the customer’s destination using total cart weight and resolved package dimensions. To protect performance and quota, the extension supports rate caching (configurable TTL) and checkout guardrails to reduce repeated calls during address entry.
Merchant controls
- Allowed USPS services and optional top-N output to keep checkout clean.
- Handling fee and markup controls for margin-safe shipping.
- Rate caching settings for faster checkout under load.
- Admin test tools for connection validation and sample rates.
Shared dimensions (suite-wide)
Other Toweringmedia carriers can share product dimensions via these attributes (for suite consistency):
- tm_pkg_length
- tm_pkg_width
- tm_pkg_height
This module estimates package dimensions from cart weight. Admin default length/width/height apply when weight is 0.
Works with the Toweringmedia Magento 2 Carrier Suite
For a consistent multi-carrier setup (shared dimensions, similar configuration patterns), pair USPS with:
Need multi-origin (dropship / multi-warehouse) USPS rating?
This base USPS module is intentionally single-origin for stability and predictable checkout behavior. If you ship from multiple vendor warehouses, extend your setup with:
Magento 2 Multi-Vendor Dropship Shipping System (UPS/USPS/FedEx Bundle)
Adds vendor-specific origins, per-origin carrier rating, and combined checkout totals while keeping the base carrier clean and reusable.
Which carrier should I enable?
| Carrier | Best for | Strengths | Notes |
|---|---|---|---|
| UPS REST API | Domestic + negotiated pricing | Service control, negotiated rates, reliable quoting | Great “primary” carrier for many stores |
| USPS REST API | Lightweight parcels + cost-sensitive shipping | Caching, top-N output, fast common routes | Web Tools migration path |
| FedEx REST API | Express + international service mix | Account vs list rating, pickup type, transit-time options | Strong for speed-focused delivery offerings |
Who this extension is for
- Stores migrating off USPS Web Tools to the modern OAuth + REST platform.
- Merchants who need real-time USPS rates at checkout (not flat estimates).
- Stores that benefit from rate caching to keep checkout fast under load.
- Catalogs that need consistent dimensions across USPS/UPS/FedEx.
- Teams that want built-in admin test tools for faster setup.
FAQ
Is this a replacement for USPS Web Tools integrations?
Yes — it’s built to migrate Magento 2 stores to USPS’s OAuth + REST API platform.
Will caching reduce repeated calls?
Yes — rate caching can significantly reduce repeat requests on common routes and improve checkout responsiveness.
Can I use this with UPS and FedEx?
Yes — the carrier suite shares dimension attributes and consistent configuration patterns.
What if I ship from multiple warehouses/vendors?
Add the Multi-Vendor Dropship bundle for per-origin rating and combined totals.
Key Features
Standalone USPS REST rates for Magento 2 cart and checkout, with caching and merchant controls.
- Live checkout rates Quotes from Magento shipping origin to the shopper destination.
- OAuth2 credentials Consumer Key and Secret with optional sandbox mode.
- Intelligent rate cache Cache rates with a configurable lifetime to cut repeat API calls.
- Services and top-N Allow specific USPS methods and optionally limit how many show.
- Fees and markup Add a flat handling fee and/or percentage markup per rate.
- Weight-based packages Estimates dimensions from weight; splits overweight carts by max package weight.
- Admin rate tests Test Connection and Test Rate Calculation before go-live.
- Debug logging Optional debug logs under var/log for troubleshooting.
Demo
Docs & Support
📘 Documentation
Follow our comprehensive guide to quickly set up and configure the USPS OAuth Shipping Extension for Magento 2. From API credentials to real-time rate validation, everything is covered step-by-step.
- Step-by-step installation and module setup
- How to create USPS developer account and API credentials
- OAuth 2.0 configuration (Consumer Key & Secret)
- Shipping method setup and service configuration
- Test Connection and Sample Rate validation
- Rate caching and performance configuration
- Troubleshooting and debug logging
💬 Support
Our Magento experts are ready to help you migrate from USPS Web Tools and ensure your REST API integration works flawlessly.
- Assistance with USPS API setup and OAuth configuration
- Help migrating from legacy Web Tools to REST API
- Shipping rate troubleshooting and checkout validation
- Configuration guidance for services, fees, and rules
- Compatibility support with Hyvä, Luma, and custom themes
- Ongoing updates and Magento version compatibility
Frequently Asked Questions
USPS has retired the legacy Web Tools API, which means older Magento integrations may stop working or provide unreliable rates. This extension ensures your store is fully compatible with the new USPS OAuth-secured REST API.
You need to create a USPS developer account and register an application to obtain your Consumer Key and Consumer Secret. These credentials are used for OAuth 2.0 authentication with the USPS REST API.
Yes, the extension includes Test Connection and Test Sample Rate features in Magento Admin, allowing you to verify authentication and confirm that shipping rates are being returned correctly.
Yes, the extension fetches real-time USPS rates based on customer location, order weight, and selected services, ensuring accurate pricing in cart and checkout.
Yes, you can enable or disable specific USPS services, apply handling fees or markups, and control how shipping options are presented to customers.
Yes, built-in rate caching reduces repeated API calls, improving speed and ensuring a smoother checkout experience for customers.
Where do I enter USPS OAuth credentials?
Go to Stores → Configuration → Sales → Delivery Methods → USPS REST API (Toweringmedia). Enter your Consumer Key and Consumer Secret, choose sandbox or live, then use Test Connection and Test Rate Calculation before enabling the method on the storefront.
What is Commercial vs Retail price type?
Under the same carrier settings, Price Type chooses COMMERCIAL or RETAIL USPS pricing for the rate request. Use the option that matches your USPS account agreement, then confirm with the admin sample-rate test.
How are heavy shipments packaged for rating?
When cart weight exceeds Maximum Package Weight (default 70 lbs), the module splits the shipment into equal-weight packages, rates each package, and combines matching service totals before checkout display.
Do you offer support?
Yes. Email support@toweringmedia.com or call (773) 466-2454. Updates and support continue while your subscription is active.
Can I try a demo?
Yes. Use the View Demo button on this page. For a guided walkthrough, email support@toweringmedia.com.
What happens when I don’t renew?
Uncheck auto-renew at purchase, or cancel later. You keep access until the end of the paid period. After that, updates and support stop.
Technical Specifications
- Magento Version: Compatible with Magento 2.4.x (Open Source & Adobe Commerce)
- PHP Version: PHP 8.1, 8.2, 8.3 compatible
- Framework: Built using Magento 2 native architecture (no core overrides)
- Installation Type: Composer / Manual installation supported
- Module Dependency: Requires toweringmedia/module-base
- API Type: USPS REST API v3
- Authentication: OAuth 2.0 (Client Credentials flow)
- Credentials Required: Consumer Key & Consumer Secret
- Legacy Support: Replaces deprecated USPS Web Tools API
- Connection Mode: Secure HTTPS API communication
- Rate Type: Real-time USPS shipping rates
- Rate Display: Cart page & Checkout page
- Supported Services: Ground Advantage, Priority Mail, Express, and more
- Rate Adjustment: Handling fees / markup supported
- Service Control: Enable/disable specific USPS services
- Rate Caching: Built-in caching for improved performance
- Package Handling: Estimates dimensions from package weight; admin defaults when weight is 0
- Multi-Store Support: Yes
- Store Scope Configuration: Website / Store View level
- Top Methods Display: Optional limit for showing best shipping options
- Admin Configuration Path: Stores → Configuration → Sales → Delivery Methods → USPS REST API
- Test Connection: Validate USPS API authentication
- Sample Rate Test: Verify shipping rate response
- Debug Logging: Optional logging for troubleshooting
- Performance Impact: Minimal (optimized API calls with caching)
Compatible with your Magento 2 store
Built for Magento 2.4.x (Open Source and Adobe Commerce) with PHP 8.1, 8.2, and 8.3. Install as toweringmedia/module-usps-rest-api (requires toweringmedia/module-base). Configure under Stores → Configuration → Sales → Delivery Methods → USPS REST API (Toweringmedia). Single-origin quoting; multi-warehouse setups pair with the Multi-Vendor Dropship bundle.
-
Magento 2.4.x
Open Source & Adobe Commerce
Updates & supportKeep your store running smoothly