Title: Beacon Shipping Rates for USPS
Author: beaconevents
Published: <strong>September 29, 2026</strong>
Last modified: September 29, 2026

---

Search plugins

![](https://ps.w.org/beacon-shipping-rates-for-usps/assets/banner-772x250.png?rev
=3719829)

![](https://ps.w.org/beacon-shipping-rates-for-usps/assets/icon-256x256.png?rev=
3719829)

# Beacon Shipping Rates for USPS

 By [beaconevents](https://profiles.wordpress.org/beaconevents/)

[Download](https://downloads.wordpress.org/plugin/beacon-shipping-rates-for-usps.0.1.4.zip)

 * [Details](https://wordpress.org/plugins/beacon-shipping-rates-for-usps/#description)
 * [Reviews](https://wordpress.org/plugins/beacon-shipping-rates-for-usps/#reviews)
 *  [Installation](https://wordpress.org/plugins/beacon-shipping-rates-for-usps/#installation)
 * [Development](https://wordpress.org/plugins/beacon-shipping-rates-for-usps/#developers)

 [Support](https://wordpress.org/support/plugin/beacon-shipping-rates-for-usps/)

## Description

USPS retired its old Web Tools API and moved to the new USPS APIs. Beacon Shipping
Rates for USPS is built for the new API from the start — with the two things store
owners kept asking for: a setup that doesn’t take an afternoon, and rates that don’t
disappear when USPS has a bad hour.

**What you get, free:**

 * **Live USPS rates at checkout** for Ground Advantage, Priority Mail, Priority
   Mail Express and Media Mail, plus First-Class Package International, Priority
   Mail International and Priority Mail Express International.
 * **A guided setup page** (WooCommerce  USPS Rates) that walks you through getting
   USPS API keys in about 15 minutes, tests the connection, and fetches a real rate
   before you touch a shipping zone. Every USPS error is translated into what to
   actually do.
 * **Rates that survive the USPS quota.** USPS allows 60 calls per hour by default.
   Identical packages are served from cache, the plugin stops calling USPS just 
   below the limit, and a stale copy is kept for a week for when USPS is down.
 * **A fallback rate** so an outage at USPS never shows customers an empty shipping
   list.
 * **Sane packing:** one box per order, per product line or per item, with automatic
   unit conversion and the 70 lb USPS limit respected.
 * **Handling markup** (fixed or percent), custom method title, Retail or Commercial
   pricing.
 * Works with shipping zones, the block cart and checkout, and High-Performance 
   Order Storage. Uninstalls clean.

You use your **own** USPS API keys — nothing is proxied through anyone’s server 
and there is no per-request fee.

**Pro** (sold separately): box packing against your real boxes, per-service rules(
markup, hide, free over, min/max), per-product service restrictions, flat-rate boxes,
and delivery-date estimates at checkout. Nothing in the free plugin moves behind
the paywall.

Beacon Shipping Rates for USPS is an independent plugin by Beacon Events. It is 
not affiliated with, endorsed or sponsored by the United States Postal Service. 
USPS, Priority Mail, Priority Mail Express, USPS Ground Advantage and Media Mail
are trademarks of the United States Postal Service.

### External services

This plugin connects to the **USPS APIs** (operated by the United States Postal 
Service) to get shipping rates. It is needed to show live USPS prices at checkout.

 * **When:** when a customer’s cart needs a shipping quote at cart or checkout (
   unless a cached rate is used), and when a store admin clicks “Test connection”
   or “Get rates” on the setup page.
 * **What is sent:** to `https://apis.usps.com/oauth2/v3/token` — the store’s own
   USPS Consumer Key and Secret, to obtain an access token. To `https://apis.usps.
   com/prices/v3/total-rates/search` and `https://apis.usps.com/international-prices/
   v3/total-rates/search` — the origin ZIP code, the destination ZIP or postal code
   and country, and package weight and dimensions. No customer names, street addresses,
   emails or order details are sent.
 * If the “USPS test environment” option is enabled, the same requests go to `https://
   apis-tem.usps.com` instead.
 * USPS terms of use: https://about.usps.com/who/legal/terms-of-use.htm
 * USPS privacy policy: https://about.usps.com/who/legal/privacy-policy/welcome.
   htm

## Screenshots

[⌊Guided setup: create your USPS API app and paste the keys.⌉⌊Guided setup: create
your USPS API app and paste the keys.⌉[

Guided setup: create your USPS API app and paste the keys.

[⌊Test the connection and get a real USPS rate before you touch a shipping zone.⌉⌊
Test the connection and get a real USPS rate before you touch a shipping zone.⌉[

Test the connection and get a real USPS rate before you touch a shipping zone.

## Installation

 1. Install and activate the plugin (WooCommerce must be active).
 2. Go to **WooCommerce  USPS Rates** and follow steps 1–4: create a free app in the
    USPS Developer Portal, paste the Consumer Key and Secret, test the connection, 
    fetch a test rate.
 3. Go to **WooCommerce  Settings  Shipping**, open a zone, add the **USPS (Beacon)**
    method and pick your services.

## FAQ

### Do I need a USPS business or shipping account?

For rates you only need a free USPS Developer Portal app. Retail prices need nothing
more. Commercial prices apply if you have a USPS commercial pricing agreement.

### Why are the rates different from usps.com?

usps.com shows Retail prices by default; if your store is set to Commercial you’ll
see commercial prices, and vice versa. Change it on the setup page.

### What happens when USPS is down or my hourly quota runs out?

Cached rates are used first (fresh for the cache period, stale for a week), then
the fallback rate you set in the method. Customers never see an empty shipping list
unless you turn the fallback off.

### How do I raise the USPS quota?

Submit a service request on the USPS Developer Portal “Email Us” page. Then raise
the hourly ceiling on the setup page to match.

### Does it print labels?

No. It quotes rates. Use your usual label tool.

### Does it work with the block checkout?

Yes, and with the classic checkout.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Beacon Shipping Rates for USPS” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ beaconevents ](https://profiles.wordpress.org/beaconevents/)

[Translate “Beacon Shipping Rates for USPS” into your language.](https://translate.wordpress.org/projects/wp-plugins/beacon-shipping-rates-for-usps)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/beacon-shipping-rates-for-usps/),
check out the [SVN repository](https://plugins.svn.wordpress.org/beacon-shipping-rates-for-usps/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/beacon-shipping-rates-for-usps/)
by [RSS](https://plugins.trac.wordpress.org/log/beacon-shipping-rates-for-usps/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.4

 * Fix: the setup page rate test now names Library Mail and Media Mail (USPS returns
   them without a product name).

#### 0.1.3

 * First release: live domestic and international USPS rates, guided setup with 
   connection and rate tests, rate cache + hourly quota guard, fallback rate, packing
   strategies, handling markup, Media Mail eligibility by shipping class, tax status,
   handling time, copy-diagnostics, extension hooks for the Pro add-on.

## Meta

 *  Version **0.1.4**
 *  Last updated **23 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [live shipping rates](https://wordpress.org/plugins/tags/live-shipping-rates/)
   [shipping](https://wordpress.org/plugins/tags/shipping/)[shipping rates](https://wordpress.org/plugins/tags/shipping-rates/)
   [usps](https://wordpress.org/plugins/tags/usps/)[woocommerce shipping](https://wordpress.org/plugins/tags/woocommerce-shipping/)
 *  [Advanced View](https://wordpress.org/plugins/beacon-shipping-rates-for-usps/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/beacon-shipping-rates-for-usps/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/beacon-shipping-rates-for-usps/reviews/)

## Contributors

 *   [ beaconevents ](https://profiles.wordpress.org/beaconevents/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/beacon-shipping-rates-for-usps/)