USPS Setup

Shipping via United States Postal Service

The USPS Shipping Module is provided as a plugin for Zen Cart.

In order to use the USPS module you need to have a USPS WebTools account registered for access to their Rate Calculator API. You must have a separate WebTools user ID for each web store.

If you have an account with USPS for using shipping assistance, this is not the same as the WebTools user ID needed for the shopping cart.

Here is the link for registering. When registering a new account, after 24-48 government hours you will receive an email from USPS with your user ID and some generic instructions.


In your Zen Cart admin area, make sure you have a zip code entered at: Admin > Configuration > Shipping/Packaging > Postal Code.

In your Zen Cart admin area, go to Admin > Modules > Shipping, and click on the USPS shipping module, click Install, and fill out the various configuration information fields.

Call USPS 1-800-344-7779 and ask them to take account out of Test (i.e.: Put it into production mode).

If your module doesn’t generate quotes properly after this, call USPS back and make sure they have enabled the RateCalculator on your account profile.

Troubleshooting Rate Calculations

The USPS module has a setting called “Debug Mode” which you can configure when you go to Admin > Modules > Shipping > USPS > Edit. Turning debug on (i.e. to Email, Logs or Screen) will show you the raw responses from the USPS server.

Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified September 4, 2020 by Chris Brown (89a7031).