Connect your Stamps.com account to show live USPS rates at checkout and buy USPS labels from your orders. Postage is paid from your Stamps.com balance, which you can top up and set to refill automatically from FirearmCart.
USPS can’t carry everything a firearms store sells. Ammunition never ships by USPS, and firearms only go by Priority Mail or Priority Mail Express. See What USPS Can Ship.
Features
| Feature | Description |
|---|---|
| Live rates at checkout | USPS rates from your Stamps.com account, for items USPS can carry |
| Postage labels | Buy, print, reprint and void USPS labels from an order, with optional insurance |
| Postage balance | See your balance, add postage and set up auto-refill |
Before You Start
You need a Stamps.com account with a payment method on file. FirearmCart connects with your Stamps.com username and password, so there are no API keys to create.
Finding Your Stamps.com Username
FirearmCart needs your Stamps.com username, not the email address you sign in with. The Stamps.com website accepts either one, but the connection FirearmCart uses only takes the username. Newer Stamps.com accounts sign in with an email address, so you may never have seen yours.
- Sign in to Stamps.com
- Open Account Settings > Users, or go straight to app.web.stamps.com/#/account/account-settings/users
- Copy your username from the list
Setting Up
- Go to Plugins > Marketplace and find Stamps.com
- Click Activate
- Enter your Stamps.com username in Username, not your email address, and your password in Password
- Leave Enable Sandbox Mode off. It connects to Stamps.com’s test environment instead of your account.
- Click Activate Plugin
FirearmCart checks your login with Stamps.com when you click Activate Plugin, and doesn’t save one Stamps.com turns down. If you change your Stamps.com password, update it with Configure on Stamps.com under Plugins > Marketplace, which checks it the same way.
The first time you activate the plugin, its ship-from address is copied from your store address under Settings > General.
Postage Balance
Plugins > Stamps.com shows your postage balance, the Stamps.com username you’re connected as, and your account status. Refresh reloads them, and Manage on Stamps.com opens your account on Stamps.com.
Adding Postage
- Click Add postage
- Enter the Amount (USD), from $1 to $500
- Click Buy postage
The amount is charged to the payment method on file in your Stamps.com account and added to your balance.
Auto-Refill
Stamps.com can buy more postage for you whenever your balance runs low:
- Turn on Auto-refill enabled
- Set Trigger when balance drops below ($). The default is $10.
- Set Auto-buy amount ($). The default is $50, and the minimum is $10.
- Click Save auto-refill
The switch takes effect as soon as you flip it. Save auto-refill saves the two amounts.
Settings
Make your changes on Plugins > Stamps.com and click Save settings.
| Setting | What it does |
|---|---|
| Show USPS rates at checkout | Quotes live USPS rates for items USPS can legally ship, in place of your paid zone rates. Off by default. |
| Rate display at checkout | Combined shows one shipping price for the whole order, named for the services its packages use, such as USPS Priority Mail + USPS Ground Advantage for a handgun and an accessory. Per package shows a separate rate for each package that has to ship on its own. |
| Rate buffer | Adds a flat amount, a percentage, or both to each live rate. See Real-Time Rate Buffer. |
| Max box weight (lb) | The heaviest box you ship, from 1 to 70 lb. A heavier order is split into several boxes, each with its own label. Leave it blank to use USPS’s 70 lb limit. |
| Ship-from address | Where your packages ship from. USPS can’t quote a rate until it has a ZIP code. |
There is no list of services to choose from: FirearmCart offers every USPS service each item may use.
Keep a paid zone rate as a backup: checkout shows it when Stamps.com can’t quote, and without one customers can’t check out then.
What USPS Can Ship
| Item | USPS services |
|---|---|
| Handguns | Priority Mail or Priority Mail Express, between licensed dealers only |
| Long guns | Priority Mail or Priority Mail Express, unloaded |
| Ammunition | Never |
| Accessories | Priority Mail, Priority Mail Express or Ground Advantage |
- Ammunition. USPS doesn’t carry ammunition, so FirearmCart never offers USPS for it. A cart with ammunition gets live rates only when UPS or FedEx is also active. With Stamps.com as your only live-rate carrier, that cart is charged your zone rates.
- Handguns. USPS only accepts handguns mailed between licensed manufacturers, dealers and importers. File PS Form 1508 with your post office when you mail one. FirearmCart doesn’t fill it in or file it for you.
- Suppressors and other NFA items, including short-barreled rifles and shotguns, can’t be mailed, so FirearmCart never offers USPS for them.
- Adult signature. Every handgun and long gun label is bought with USPS Adult Signature Required, and live rates include it.
See Shipping Firearms for how a cart is split into packages.
Buying Labels
Buy labels from the order page: open the fulfillment’s menu and choose Buy & print label. Postage comes out of your Stamps.com balance. Enter an amount in Insure for ($) to add Stamps.com insurance. Each time you reprint a label, a fresh copy is fetched from Stamps.com. See Shipping Orders.
Troubleshooting
Stamps.com Authentication Failed
A message starting Stamps.com authentication failed means Stamps.com turned down your login. It shows under Username when you activate the plugin or save it with Configure, and on Plugins > Stamps.com after Test connection.
Most often Username holds the email address you sign in to Stamps.com with. The Stamps.com website accepts it, so the same login can work there and still fail here. Enter your Stamps.com username instead. If the username is right, check the password by signing in to Stamps.com with that username.
A Label Purchase Fails
Check your postage balance on Plugins > Stamps.com and add postage if it’s low, or turn on auto-refill so it doesn’t run out.
No USPS Rates at Checkout
- Show USPS rates at checkout is off
- The ship-from address has no ZIP code
- The cart has ammunition, a suppressor or another NFA item, and no UPS or FedEx plugin is active
- An item is heavier than your Max box weight, or 70 lb, and can’t be split across boxes
Related Documentation
- Shipping Orders - Buy, print and void labels
- Shipping Firearms - Carrier rules for each item type
- Shipping - Zone rates and the rate buffer
- FedEx - FedEx rates and labels
- UPS - UPS rates and labels

