Stamps4ZenCart: USPS labels from your Stamps.com account [Support Thread]

Stamps4ZenCart v1.0.0 lets you buy and print USPS shipping labels from your own Stamps.com account without leaving the Zen Cart admin. It's free and GPL v3.

Download: https://github.com/dbltoe/Stamps4ZenCart/releases/tag/v1.0.0

What it does

• Opens from a Stamps.com Label button on the order page, with the ship-to address filled in from the order.
• Checks the address against USPS records, with a one-click correction.
• Shows USPS rates for your account, cheapest first, with your Stamps.com balance alongside.
• Buys the label and prints it at real size on any printer. I've printed on a DYMO LabelWriter 4XL; Zebra and plain sheet printers work too, and there's a Download PDF.
• Voids unused labels, shows tracking, schedules next-day USPS pickups and creates SCAN forms.
• Writes the tracking number to the order history, with an optional customer email and status change.
• Prints a free sample label so you can line up your printer before buying a real one.

Version 1.0.0 makes labels for U.S. addresses.

What you need

• Zen Cart 1.5.8 through 3.0.0, PHP 7.4 through 8.5 with curl.
• A Stamps.com account with postage funds. You don't need a Stamps.com developer account.

How the connection works

Stamps4ZenCart is a registered Stamps.com integration. You click Connect to Stamps.com and sign in on Stamps.com's own page, so your password goes only to Stamps.com. A small myZenCartZone connection service holds the integration's client secret, which can't be shipped in a GPL download, and handles the sign-in and its refresh. It never stores your Stamps.com sign-in, and there's no charge for it. Rates, labels, tracking, pickups and SCAN forms go directly between your store and Stamps.com.

Getting started

1. Copy zc_plugins/Stamps4ZenCart into your store's zc_plugins folder.
2. Install it under Modules > Plugin Manager.
3. Fill in your ship-from address under Configuration > Stamps4ZenCart.
4. Go to Customers > Stamps4ZenCart Labels and click Connect to Stamps.com.

The full guide is in the download's README.md, and once it's installed, the ReadMe button in Plugin Manager opens it for superusers.

For developers

The Create Label page has notifiers for add-ons: allowing an order outside the U.S., adding form fields, changing what's sent to Stamps.com before rates and before buying, and reacting to a bought or voided label. They're documented in docs/CUSTOMIZING.md.

Support

Please post questions and problems here. It helps to include your Zen Cart and PHP versions and the exact message you see. If Log Stamps.com Errors is on, the failed request is in logs/stamps4zencart-YYYYMM.log; it never contains tokens, keys or addresses, so the relevant lines are safe to post.

Stamps.com is a trademark of its owner; Stamps4ZenCart is an independent integration that uses the Stamps.com API.