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 production RatesV4 and IntlV2 APIs. 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.

Several steps are required to get everything you need; please see the instructions for Getting USPS Credentials.


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.

You must complete all the steps in Getting USPS Credentials before you will be able to go live.

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.

USPS Password Now Required

The USPS now requires that you enter your password in the config; see the USPS wiki for instructions on retrieval if you have forgotten it.

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 February 15, 2024 by Scott Wilson (df7f27a).