No rate appears at checkout
The plugin shows no rate rather than a wrong one. Check, in order:
- The method is in the zone. WooCommerce → Settings → Shipping → Shipping zones: the zone matching the shopper's address must contain USPS (Gatemi) (free) or the carrier's method (full). Credentials alone do not put rates on the checkout.
- Credentials are saved. Free: consumer key, consumer secret and a ZIP code. Full: on the carrier's tab, Quote carrier rates is ticked and the screen says "Credentials saved"; press Test connection.
- There is a ship-from postcode. Either typed on the screen or in your WooCommerce store address.
- Free edition: the store sells in US dollars. USPS prices in dollars; in any other currency the free edition offers nothing.
- The destination is complete. A US address needs a ZIP code before USPS can price it.
- The cart has something that ships. Virtual and downloadable products are not sent to the carrier.
- Full edition: a service is enabled for that route (domestic or international) in the carrier's Services table, and priced every parcel.
- Full edition: the carrier ships from your country. USPS quotes from the US, Australia Post from Australia and Canada Post from Canada; the screen warns when your ship-from address does not match.
Full edition: turn on Log carrier requests and responses and look in WooCommerce → Status → Logs for gatemi-carrier-shipping — the carrier's own error message is there.
The rate seems too low
Check your products' dimensions under Product data → Shipping — a parcel with no dimensions is priced at the carrier's minimum size, which can quote less than the real parcel will cost.
No rate shows when one product has no weight
That is deliberate. A cart holding a product with no weight is not quoted live — sending it at the carrier's minimum weight would quote less than the real parcel costs. Free edition: that cart gets no rate from this method. Full edition: only the zone method's Fallback price is offered, if you set one. Give every shipped product a weight under Product data → Shipping.
Full edition: check the packing method, too — "one parcel, combined weight" and "one parcel per item" can give quite different prices — and whether destinations should be treated as residential.
Why only one rate in the free edition?
The free edition offers the single cheapest USPS service that can carry the whole order. The full edition can offer every service the carrier returned, with your own names and markups.
I changed my credentials but nothing changed
Free edition: a successful quote is kept for 10 minutes. Wait, or change the cart, and the new credentials are used.
Full edition: saving the settings retires every cached quote and forgets every token, so the next page load asks the carrier again. A quote answer — including an empty one after a carrier outage — is otherwise kept for 12 hours; save the settings to clear it.
Does it work with the Checkout block?
Yes. Rates are ordinary WooCommerce shipping rates, so the classic checkout, the Cart and Checkout blocks and the Store API all show them. Both editions declare block and HPOS compatibility.
Does a page cache affect rates?
No. Cart and checkout pages are not cached by page caches, and rates are calculated by WooCommerce on the server for each cart.
Is my consumer secret safe?
It is stored in the plugin's settings in the WordPress options table (it is not encrypted), never printed back on the screen (a mask stands in), and, in the full edition, redacted from logs. The free edition never sends it anywhere except USPS when asking for an access token.
What data is sent to the carrier?
Your API credentials (to get an access token), your ship-from address or ZIP, the shopper's destination, and each parcel's weight, dimensions and declared value. The free edition contacts only apis.usps.com; it never contacts gatemi.com.
Moving from the free edition to the full edition
The two editions keep separate settings (gmcsf_settings and gmcs_settings) and separate shipping methods (gmcsf_usps and gmcs_usps), but the full edition brings the free edition's set-up across on its first run, once:
- your USPS consumer key, consumer secret and ship-from ZIP are copied into the full edition's settings, with Quote USPS rates switched on — only if the full edition has no settings of its own yet;
- every enabled USPS (Gatemi) method in a shipping zone gets a full edition USPS method beside it, with the same title — unless that zone already has one.
Nothing of the free edition's is changed or deleted. After that:
- Check the full edition's USPS tab and your zones under WooCommerce → Settings → Shipping.
- Deactivate the free edition (it stands down on its own once the full edition is active), and remove the old USPS (Gatemi) rows from your zones when you no longer need them.
What happens when I uninstall?
Free edition: removes gmcsf_settings and its cached tokens and quotes.
Full edition: removes gmcs_settings, the cache generation counter, the licence, its update cache and cron event, every cached quote and token, and the zone-method settings WooCommerce stored for its methods.
Orders are not touched: rates already charged stay on past orders.
Does it print labels or track parcels?
No. Both editions quote rates at checkout. Labels, tracking and address validation are not part of either edition.
