USPS OAuth Shipping

Published on: December 31, 2025

Last updated: March 7, 2026

USPS OAuth shipping label showing real-time postage details used by the M Media USPS OAuth Shipping Module for WooCommerce

Real-time USPS shipping rates for WooCommerce using the new OAuth API

The United States Postal Service is in the middle of a significant infrastructure transition. Legacy shipping APIs are being deprecated and replaced with OAuth-based authentication, a change that directly affects how shipping rates are calculated and displayed in WooCommerce stores. Many existing USPS integrations rely on older authentication models that will either require substantial rewrites or stop functioning altogether as USPS completes this migration. For store owners, this isn’t a theoretical concern – inaccurate or failing shipping rates can break checkout and quietly cost sales.

M Media USPS OAuth Shipping is built specifically for this transition.

The plugin provides real-time USPS shipping rates for WooCommerce using the new USPS OAuth API (2026+), ensuring your store continues to quote accurate, compliant shipping rates without disruption as USPS retires legacy endpoints.

Built for the Next Generation of USPS APIs

M Media USPS OAuth Shipping uses OAuth 2.0 authentication, as required by the current USPS API platform. Rather than layering compatibility shims on top of outdated methods, the plugin communicates with USPS using the same standards USPS expects going forward.

This approach provides secure, standards-based authentication, compatibility with USPS’s current and future API infrastructure, and eliminates reliance on legacy or deprecated endpoints. If you’re planning for the next few years – not just the next few weeks – this plugin is designed to stay aligned with USPS requirements.

Built for the USPS OAuth transition
A WooCommerce-native USPS rates plugin that speaks OAuth 2.0 — so your checkout doesn’t break when legacy endpoints fade into history.
  • OAuth 2.0 (2026+ ready)
  • Live rates at checkout
  • Sandbox mode for testing
  • Fallback rates when APIs fail

Accurate, Real-Time Shipping Rates

During checkout, the plugin retrieves live shipping rates directly from USPS based on the actual shipment details of the customer’s order. Rates are calculated using package weight, dimensions, destination address, and the USPS services you choose to offer.

Rates are calculated in real time and displayed clearly and reliably to customers, avoiding guesswork or stale estimates that can lead to abandoned carts.

Supported domestic services include Media Mail, USPS Ground Advantage, and Priority Mail. International services include First-Class Package International, Priority Mail International, and Priority Mail Express International.

Designed for Real WooCommerce Stores

Developer Links

This plugin is powered by our open-source USPS OAuth PHP library. Browse the code, track releases, or pull it in via Composer.

Composer:
composer require mmediasoftwarelab/usps-oauth-php

M Media USPS OAuth Shipping integrates cleanly with WooCommerce’s native shipping system rather than replacing it. This allows you to continue using familiar WooCommerce concepts such as shipping zones while gaining OAuth-compliant USPS rate calculation.

The plugin supports multiple USPS services per zone, fixed handling fees, percentage-based rate adjustments, automatic unit conversion (lbs, kg, oz, g), and flexible package dimensions defined per product or via store defaults. You remain fully in control of how shipping costs are presented and adjusted for your business.

Sandbox Mode for Safe Testing

The plugin includes Sandbox Mode, allowing you to configure and test behavior using USPS’s test environment before switching to production credentials.

This makes it possible to verify OAuth credentials, test checkout behavior, confirm rate calculations, and avoid unpleasant surprises on a live store.

Resilience When APIs Fail

Shipping APIs are not immune to downtime. To prevent checkout disruption during USPS outages or network failures, M Media USPS OAuth Shipping supports configurable fallback rates.

If the USPS API is unavailable, customers are shown a predefined estimated rate instead of an error message, allowing checkout to continue normally while protecting conversion.

Commercial Support Available

This plugin is developed and maintained by M Media, a software company focused on practical, lightweight tools that do exactly what they claim – without unnecessary dependencies or feature bloat.

Professional support and services are available for setup assistance, troubleshooting, advanced configuration, and long-term maintenance planning.

Requirements

To use this plugin, your environment must meet the following requirements:

  • WordPress 5.8 or higher
  • WooCommerce 5.0 or higher
  • PHP 7.4 or higher
  • A free USPS Business Account with API credentials

USPS credentials are created and managed through the USPS Business Gateway and entered directly into the plugin’s settings. No credentials are stored outside your site.

Privacy & Data Handling

M Media USPS OAuth Shipping does not collect or store personal data.

Shipping information is transmitted to USPS only for the purpose of rate calculation during checkout, in accordance with USPS API requirements. No shipping or customer data is retained by M Media.

Who This Plugin Is For

This plugin is intended for WooCommerce store owners who rely on USPS for domestic or international shipping, want to remain compliant with USPS’s OAuth-based API changes, prefer transparent pricing without vendor lock-in, and value stability and forward compatibility over unnecessary features.

🤖
Support Bot
"Have you tried restarting your computer? Please check our knowledge base. Your ticket has been escalated. Estimated response: 5-7 business days."
❌ Corporate Script Theater
👨‍💻
Developer (M Media)
"Checked your logs. Line 247 in config.php — the timeout value needs to be increased. Here's the exact fix + why it happened. Pushed a patch in v2.1.3."
✓ Real Technical Support

Support From People Who Understand the Code

Ever contact support and immediately know you're talking to someone reading a script? Someone who's never actually used the product? Yeah, we hate that too.

M Media support means talking to developers who wrote the code, understand the edge cases, and have probably hit the same problem you're dealing with. No ticket escalation theatrics. No "have you tried restarting?" when your question is clearly technical.

Documentation written by people who got stuck first. Support from people who fixed it.

We don't outsource support to the lowest bidder or train AI on canned responses. When you ask a question, you get an answer from someone who can actually read the logs, check the source code, and explain what's happening under the hood.

✓ Real troubleshooting, not corporate scripts
✓ Documentation that assumes you're competent
✓ Email support that doesn't auto-close tickets
✓ Updates based on actual user feedback
// real.developer.js
const approach = {
investors: false,
buzzwords: false,
actualUse: true,
problems: ['real', 'solved']
};
// Ship it.

Built by People Who Actually Use the Software

M Media software isn't venture-funded, trend-chasing, or built to look good in pitch decks. It's built by developers who run their own servers, ship their own products, and rely on these tools every day.

That means fewer abstractions, fewer dependencies, and fewer "coming soon" promises. Our software exists because we needed it to exist — to automate real work, solve real problems, and keep systems running without babysitting.

We build software the way it used to be built: practical, durable, and accountable. If a feature doesn't save time, reduce friction, or make something more reliable, it doesn't ship.

✓ Every feature solves a problem we actually had
✓ No investor timelines forcing half-baked releases
✓ Updates add value, not just version numbers
✓ Documentation written by people who got stuck first

This is software designed to stay installed — not be replaced next quarter.