USPS Setup

Shipping via United States Postal Service

In order to use the USPS module, you need to have a USPS WebTools account, signed up to use their Rate Calculator API.

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.

You must have a separate WebTools user ID for each web store.

Here is the link for registering.

You will soon (24-48 government hours) receive e-mail 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? No problem! Just 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 August 8, 2020 by Scott C Wilson (392e8f6).