---
title: "Stamps.com"
description: "Show live USPS rates at checkout and buy USPS labels from your orders through your Stamps.com account, manage your postage balance, and see what USPS can and can't carry"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.firearmcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stamps.com

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](#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.

1. Sign in to Stamps.com
2. Open **Account Settings > Users**, or go straight to [app.web.stamps.com/#/account/account-settings/users](https://app.web.stamps.com/#/account/account-settings/users)
3. Copy your username from the list

---

## Setting Up

1. Go to **Plugins > Marketplace** and find **Stamps.com**
2. Click **Activate**
3. Enter your [Stamps.com username](#finding-your-stampscom-username) in **Username**, not your email address, and your password in **Password**
4. Leave **Enable Sandbox Mode** off. It connects to Stamps.com's test environment instead of your account.
5. 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

1. Click **Add postage**
2. Enter the **Amount (USD)**, from $1 to $500
3. 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:

1. Turn on **Auto-refill enabled**
2. Set **Trigger when balance drops below ($)**. The default is $10.
3. Set **Auto-buy amount ($)**. The default is $50, and the minimum is $10.
4. 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](/store-setup/shipping#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](/store-setup/shipping#keep-a-backup-rate-for-real-time-rates): 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](/ffl-compliance/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](/orders/shipping).

---

## 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](#finding-your-stampscom-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](/orders/shipping) - Buy, print and void labels
- [Shipping Firearms](/ffl-compliance/shipping-firearms) - Carrier rules for each item type
- [Shipping](/store-setup/shipping) - Zone rates and the rate buffer
- [FedEx](/integrations/fedex) - FedEx rates and labels
- [UPS](/integrations/ups) - UPS rates and labels

Source: https://docs.firearmcart.com/integrations/stamps-com/index.mdx
