Magento 2 USPS Shipping Extension – Real-Time USPS Rates via REST API v3
-
Real-time USPS shipping rates at Magento 2 checkout using USPS REST API v3.
-
Secure OAuth2 authentication replacing legacy USPS Web Tools integrations.
-
Built-in rate caching improves checkout speed and reduces API calls.
-
Supports Ground Advantage, Priority Mail, Express, and First-Class services.
-
Includes admin Test Connection and Test Rate tools plus optional debug logging
Description / Magento 2 USPS Shipping Extension – Real-Time USPS Rates via REST API v3
✔ 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 with shared package dimensions and dimension modes (product_attributes, auto_dim_weight, hybrid_fallback).
- 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)
Keep one set of product dimensions across all Toweringmedia carriers using shared attributes:
- tm_pkg_length
- tm_pkg_width
- tm_pkg_height
Dimension modes: product_attributes, auto_dim_weight, hybrid_fallback (recommended).
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.